Manifold NFT Minting Skill

Build custom NFT minting experiences using @manifoldxyz/client-sdk.

References

Load lazily — only when the current step needs them. Never load all at once.

Workflow

Follow in order. Ask questions — don’t assume.

Step 1: Check if they have a Manifold campaign

Ask: “Do you already have a Manifold product/campaign deployed with an instance ID?”

• No → Read references/studio-setup-guide.md. Guide them through product type selection and Studio setup. Return when they have an instance ID.
• Yes → Continue.

Step 2: Determine project context

Ask: “Do you have an existing project to add minting to, or building from scratch?”

Existing project:

1. Ask their framework and wallet library (wagmi, viem, ethers v5)
2. Read references/getting-started.md + references/adapters.md
3. Match adapter setup to their stack — integrate, don’t scaffold

From scratch:

1. Ask what they’re building:
   • Web minting page → Read references/react-minting-app.md
   • Server-side bot → Read references/minting-bot.md
   • Data query script → Read references/getting-started.md only

Step 3: Implement product interaction

1. Read references/product-types.md — use type guards (isEditionProduct, isBlindMintProduct)
2. Read references/product-data.md — status, allocations, metadata display
3. Read references/purchase-flow.md — two-step prepare → purchase
4. If ERC-20 pricing → also read references/transaction-steps.md

Step 4: Error handling

Always before finalizing:

1. Read references/error-handling.md — ClientSDKError handling + common pitfalls
2. If multi-chain → read references/networks.md

Rules

• Never fabricate SDK method signatures or field names. Verify against references.
• Always use type guards before accessing product-specific methods.
• Always check getStatus() before purchases.
• Use preparePurchase → purchase for simple flows. Manual step.execute() only for granular UI control.
• Never hardcode chain IDs — use configuration.
• Never commit private keys — use environment variables.
• Verify code against official docs at docs.manifold.xyz/client-sdk.
• For issues beyond SDK scope → Manifold Help or Forum.