Today’s release is overflowing with improvements to your overall experience with Pieces as well as the Pieces API. From saving collections of curated, popular snippets to personalized domains for link sharing (claim your domain today!), we’ve designed every feature in this release to make Pieces even more helpful to your workflow.
Coming soon: Collections for even more languages and frameworks, user-curated collections and team-specific collections!
These collections are useful for developers of all stages, from beginners to experts. When you add a collection to Pieces, not only do you save the snippets, but also their descriptions, tags, related links, and other metadata.
To add a collection, hit [Shift+Cmd/Ctrl+C] from within the Pieces desktop app or visit code.pieces.app/collections. With a single click, you’ll be able to instantly add collections or read more about each snippet and its related context.
Sharing your snippets and all associated info (description, related links, tags) with one-click is game-changing. On the receiving end, it’s helpful to know who sent the link before clicking on it, and with today’s release, you can register your personalize cloud domain so all your shared snippets can be tied to you.
To claim your domain, go to Settings in the Pieces desktop app and simply edit your personal domain. All your future shareable links will be sent from [username].pieces.cloud.
Note: You must have an account and be connected to the cloud to claim your personal domain.
Sometimes, there’s information in your snippets that you don’t want to share. With today’s release, Pieces auto-magically highlights sensitive data in your snippets to prevent unwanted sharing and add another layer of security.
You can also manually mark information as sensitive and choose the level of sensitivity, from low to high. To view and manage your sensitive information, hit [Cmd/Ctrl + !]
While you navigate Pieces for Developers, you’ll see tips that help you discover new features and how to use them.
We’ve also improved the error screen to give you more information if something goes wrong and upgraded the reliability and performance of Pieces through various bug fixes and optimizations.
All the features you see in Pieces for Developers as well as Pieces plugins are powered by the Pieces API. If you are a developer with a vision for a tool or feature for your own product that can utilize our APIs, reach out to us directly at firstname.lastname@example.org.
As we build more infrastructure around sharing, it’s important to associate the relevant people with the share, such as the creator, sharer, and maybe even those who helped curate the snippet itself.
We layered in a Persons model to individual assets so developers can associate people with an asset. The first example of this is in the creation flow, where we now attach the creator of the asset, and with sharing, we will attach the sharer.
This model comes with all basic CRUD operations behind secure endpoints so developers can manually add, update, and delete Persons at their own discretion.
Similar to Persons, we found it important to associate any sensitive information with a snippet so developers can add in extra layers of security and prevent unwanted shares and more.
Sensitives is a model added to an asset that contains any sensitive information related to the asset. The first example of this is in the creation flow, where we proactively detect and associate any sensitive information contained in a saved asset.
This model also comes with all basic CRUD operations behind secure endpoints so developers can manually add, update, and delete Sensitives at their own discretion.
This endpoint is designed to provide recommendations on snippets to upload. This can be useful when trying to eliminate duplicate uploads or for added security measures.
Developers simply pass a SeededAsset list with the option to automatically upload, and we return the snippets we believe you should upload. If automatic is set to true, we will upload them for you!
Discover sensitives is a way to detect if an arbitrary string contains any sensitive data. This is a great way to know whether or not to have added security features around a snippet.
This endpoint accepts a list of strings with the option to automatically upload, and we return all the detected sensitive data. If an asset is associated and automatic is set to true, we will automatically attach this sensitive information to the asset.
With the addition of /database/import and /database/export endpoints, a developer now has the ability to export their entire database and import it on another machine. We are very excited about this capability and the features it will unlock for teams and enterprises.
This endpoint paves the way for the first version of collections. With this, a developer can take a list of multiple assets and generate a single link representing all of them. You can see this in action with the Pieces Collections at code.pieces.app/collections.