Best practice

NOTE: this page is in draft and is subject to change.

This page has advice on how you should implement your blocklet and list it in the store. As the store matures and we learn from developers' experiences, these recommendations will be updated.

Design a high-quality blocklet#

We encourage you to develop blocklets that are of high quality. High-quality blocklets conform to standards of performance, security, and user experience, as summarized by the following guidelines:

• Security: Is the blocklet safe for users? Make sure your blocklet does not pose security threats and does not use deceptive usage tactics.
• User privacy: Make sure that your blocklet handles user data appropriately and conforms to data privacy requirements.
• Performance: Does the blocklet function at an outstanding level? High-quality blocklets don't just perform their intended action, they do so while using as few system resources as possible.
• User experience: Is the blocklet a joy to use? The blocklet itself should provide a good-looking, intuitive, and seamless user experience while also respecting the end user's privacy.
• Store listing: The blocklet's listing should set the user's expectations and clearly communicate what the blocklet does. All image assets (icon, tile, marquee, and screenshots) should be provided. Images should not be blurry or too busy. Privacy information (permissions justifications, the blocklet's privacy policy, data use disclosures, etc.) must be accurate and up to date.

Support DID#

If your blocklet requires user login, we recommend that you provide at least some support for DID Connect. DID Connect can help you provide a better user experience: users won't have to set up and remember username and password, they just need to review and confirm information requested by your blocklet on their DID Wallet.

If you already have a login system, consider correlating the DID to the user account in your system.

Create a compelling store listing#

The better your blocklet's listing in the store, the more users will find and try your blocklet. When choosing your blocklet's name, writing its description, and designing its logo, keep in mind our guidelines.

Provide great images#

See Supplying Images for guidelines on the images you should supply to the store.

Provide concise information#

See Listing information for guidelines on information you should supply to the store.