Designing blockchain applications for Ledger devices

These guidelines contain best practices to design a great experience for users of your apps.

If you’re developing your app using Ledger’s high-level APIs and standard transaction templates, then it will already conform to these design guidelines.

Which apps are covered in these guidelines?

These guidelines apply to blockchain-related apps that fall into the standard use cases of sending crypto and NFTs, verifying addresses, or signing messages. This is the majority of apps that are available today on Ledger’s app store.

Apps with more specific needs and interfaces are not covered by these guidelines, however the general principles described here on usability and wording are a great place to start. To access the complete library if needed, visit the NBGL repository.

Ledger Stax, Flex, and Nano devices, what’s different as an app developer?

Whether you start developing your app on Ledger Stax, Ledger Flex, Nano S Plus or Nano X, porting it to the other Ledger devices will require little to no code change, as all devices use the same APIs and graphical libraries.

The same app code scales to both Ledger Stax and Ledger Flex UI, including interaction and navigation changes.

On Ledger Nano S Plus and Nano X, it can result in multiple screens if needed.

Your app’s UI will be automatically adapted to the device model you target when building your app, dynamically adjusting the size, elements, and number of pages. This works best if you use the high-level API endpoints known as “use cases”.