Getting Started
Set up local Andamio development in 15 minutes
Getting Started
~15 minutes
|6 steps
|BeginnerSet up your local development environment and run the Andamio app template.
Prerequisites
- Node.js 20+ and npm 10+
- Cardano wallet on preprod with test ADA — Setup guide
Mint Your Access Token
Your Access Token is your on-chain identity for Andamio.
- Go to preprod.app.andamio.io
- Click Enter → Connect Wallet
- Connect your wallet (preprod network)
- Enter an alias (permanent)
- Click Mint Access Token and sign
- Wait ~20 seconds for confirmation
Generate an API Key
- Go to preprod.app.andamio.io/api-setup
- Connect your wallet
- Sign in to the Gateway
- Select preprod
- Click Generate API Key
- Name it (e.g., "local-dev")
Save your key
Copy the key immediately — it won't be shown again.
Clone and Install
git clone https://github.com/Andamio-Platform/andamio-app-template.git
cd andamio-app-template
npm installConfigure Environment
cp .env.example .envEdit .env:
NEXT_PUBLIC_ANDAMIO_GATEWAY_URL="https://preprod.api.andamio.io"
ANDAMIO_API_KEY="your-api-key-here"
NEXT_PUBLIC_CARDANO_NETWORK="preprod"
NEXT_PUBLIC_ACCESS_TOKEN_POLICY_ID="29aa6a65f5c890cfa428d59b15dec6293bf4ff0a94305c957508dc78"Verify Setup
- Click Enter
- Connect your wallet
- You should see your dashboard with your alias
Setup complete.
Ready for Mainnet?
These docs use preprod (Cardano testnet) for safe development. When your app is ready for production:
- Generate a mainnet API key at app.andamio.io/api-setup
- Update
.envwith mainnet settings — see Environment Reference
Troubleshooting
"Access Token not found" — Check your wallet is set to preprod network.
"Invalid API key" — Verify .env has no trailing whitespace and uses double quotes.
"Failed to fetch" — Test the gateway: curl https://preprod.api.andamio.io/health
Build errors — Regenerate types: npm run generate:types