Miden Agentic Template

A full-stack Miden development workspace combining smart contract development (Rust SDK) with a web frontend (React + @miden-sdk/react). Both templates are included as git submodules.

Getting Started

Prerequisites

• Rust (stable toolchain)
• midenup toolchain (provides cargo-miden)
• Node.js (v18+)
• Yarn (v1)

Clone

git clone --recurse-submodules https://github.com/0xMiden/agentic-template.git
cd agentic-template

If you already cloned without --recurse-submodules:

git submodule update --init --recursive

Install Dependencies

# Frontend dependencies
cd frontend-template && yarn install && cd ..

Rust dependencies are handled automatically by cargo.

Structure

agentic-template/
  project-template/           # Miden smart contracts (Rust SDK)
    contracts/                 # Account components, note scripts, tx scripts
    integration/               # Integration tests and deployment scripts
  frontend-template/           # Miden web frontend (React + TypeScript)
    src/                       # React components, hooks, tests
    public/packages/           # Compiled contract artifacts (.masp files)

Development Workflow

1. Build contracts in project-template/contracts/
2. Test contracts with cd project-template && cargo test -p integration --release
3. Copy artifacts from contract build output to frontend-template/public/packages/
4. Build frontend in frontend-template/src/
5. Run frontend with cd frontend-template && yarn dev

AI Developer Experience

This template is designed for AI-assisted development. Open Claude Code (or Codex, Cursor) at the repository root and describe what you want to build.

• CLAUDE.md at root provides the monorepo overview and workflow
• Each sub-template has its own CLAUDE.md with detailed instructions
• Skills load automatically when working in either template
• Hooks verify contract builds and frontend type safety on every edit

Skills

Template	Skills
project-template	miden-concepts, rust-sdk-patterns, rust-sdk-pitfalls, rust-sdk-testing-patterns, rust-sdk-source-guide
frontend-template	miden-concepts, react-sdk-patterns, testing-patterns, frontend-pitfalls, vite-wasm-setup, signer-integration, frontend-source-guide

Hooks

Trigger	Action
Edit contract file	Auto-build the modified contract
Edit frontend file	Type check + run affected tests
Task completion	Full verification (all tests + typecheck + build)

Updating Submodules

To pull the latest changes from both templates:

git submodule update --remote --merge
git add project-template frontend-template
git commit -m "Update submodules to latest"