For dApps & ServicesDevice AppIntegration walkthroughsHow-toApp Boilerplate

App Boilerplates: C & Rust

The Boilerplates showcase the Ledger Device SDK and the surrounding development tooling (Docker containers, Speculos emulator, Ragger test framework). It contains examples for APDU handling, UI flows, cryptography, build/test/CI integration.

Who is it for

  • Developers beginning Ledger signer app development.
  • Developers who want a concise reference for build, test and CI logic in a Ledger signer app.

Quick start

Fork the App Boilerplate (C)

Click here to fork the repository and start your project.

Use the VSCode Extension

Use Ledger’s VSCode developer tools to build, run on Speculos, run functional tests and load on a device from the VSCode UI.

Continuous Integration (CI)

Two workflows are required for an app submission: Build_and_functional_tests and Guidelines_enforcer.

⚠️
Setting up an efficient CI pipeline is crucial for your project’s success. The Guidelines enforcer and Build and Run functional tests workflows are mandatory for submitting your device application for review.

Build_and_functional_tests

Build_and_functional_tests builds the app and runs functional tests using Ragger + Speculos.

Guidelines_enforcer

Guidelines_enforcer calls a reusable guidelines_enforcer workflow used for submission checks.

Next steps

After forking either boilerplate and reviewing the included CI workflows and guidelines, adapt the application to your project by updating metadata, implementing APDU handlers, and designing UI flows that follow the Graphic Library Usage Guidelines.

Ledger
Copyright © Ledger SAS. All rights reserved. Ledger, Ledger Stax, Ledger Nano S, Ledger Vault, Bolos are trademarks owned by Ledger SAS