Skip to content

The Create tab on bitbadges.io: the In-Site template forms, the Programmatic path for AI and CLI builds, and what each form step does.

The Create tab is the fork between two ways to build: a template form on the site, or a transaction built by your own AI or the bb CLI. The URL is bitbadges.io/create.

1. Choose In-Site or Programmatic

The Create tab on In-Site, showing the grid of template forms and the Other Services rowThe Create tab on In-Site, showing the grid of template forms and the Other Services row

The two tabs at the top of the card:

  • In-Site: a grid of template forms. Each card is one product shape with sensible defaults.
  • Programmatic: instructions for building with Claude Code, Codex, Cursor, any MCP client, or the CLI, then reviewing and signing on the site.

Both paths end at the same review step and the same wallet signature.

2. Pick a Template

The In-Site grid, as of this writing:

CardBuilds
TokensThe full customization form, for any collection shape
Smart TokenA 1:1 reverse-wrap of USDC, ATOM, or another ICS20 asset with your own rules
Payment RequestA one-action pay request to a specific address
BountyAn escrowed bounty with a verifier and an expiration
VaultAn IBC-backed vault with spending limits and recovery rules
SubscriptionsRecurring, time-dependent tokens
Custom 2FATime-dependent tokens for two-factor checks
Fungible Token, NFTThe two basic collection shapes
QuestsPayout plus an NFT when users complete tasks
Credit TokenNon-transferable credits bought with any ICS20 denom
Crowdfund, Auction, Products, Prediction MarketCampaign, single-item sale, storefront, and binary market
Address ListAn on-chain list with manager-controlled membership

Other Services covers things that are not collections: Claims, Dynamic Stores (On-Chain), and Dynamic Stores (Off-Chain).

Every template form is a signed-in page. The site asks you to connect and sign in first.

3. Fill In the Form

Each template opens at bitbadges.io/mint/<template>, for example /mint/subscriptions.

The Create Subscription form with the step sidebar on the left and the Metadata, Tiers, and Post-Mint Transferability fieldsThe Create Subscription form with the step sidebar on the left and the Metadata, Tiers, and Post-Mint Transferability fields

The left sidebar is the step list. Form is where you type; the rest are read-only views of what the form produces.

StepWhat it does
FormMetadata (image, name, description), the template's own fields (tiers for a subscription), and the post-mint switches: Transferable, Burnable, Revocable by manager
PreviewThe collection page as it will look after creation
Review ItemsFlags the form raised, such as a missing image or an open permission. The badge count is the number still open
TransferabilityThe approvals the form generated
PermissionsThe manager permissions the form will lock or leave open
Details, Compatibility, AlternativesSummary, wallet and chain compatibility, and other templates that fit the same need

Move between steps freely; the form keeps its state. The Create button at the bottom of the form opens the wallet for the signature.

4. Take the Programmatic Path Instead

The Create tab on Programmatic, showing the AI conversation example and the CLI cheat sheetThe Create tab on Programmatic, showing the AI conversation example and the CLI cheat sheet

The Programmatic tab shows the loop in two panels:

  1. Describe the token to your AI. The tool builds and checks it, then prints a link of the form bitbadges.io/mint/local-builder?code=prv_....
  2. Open the link, or paste the JSON on Review and Sign.

The lower panel is a bb CLI cheat sheet: install, the Claude Code plugin, transactions, queries, wallet commands, and the streamlined use-case commands. The Build with your AI link opens the setup page for each harness.

What You Can Do Here

  • Start a template form for the common product shapes.
  • Create a standalone claim or a dynamic store.
  • Switch to the programmatic path and read the CLI cheat sheet.
  • Return to a form later; the Developer Portal lists what you created.

Edit this page on GitHub