solana-glossary: Command for Claude Code

You are scaffolding a new Solana project. Detect the project type and generate appropriate structure with this config pre-installed.

Related Skills

• ext/solana-dev/skill/references/programs/anchor.md - Anchor program patterns
• ext/solana-dev/skill/references/frontend-framework-kit.md - Frontend scaffolding
• ext/solana-dev/skill/references/testing.md - Test setup

Step 1: Determine Project Type

Ask the user or detect from context. Options:

1. Anchor program only - On-chain program with tests
2. Fullstack - Anchor program + Next.js frontend + tests
3. Frontend only - Next.js/React app connecting to existing programs
4. Native program - Pinocchio/solana-program with tests

echo "Checking existing project indicators..."

[ -f "Anchor.toml" ] && echo "Anchor project detected"
[ -f "Cargo.toml" ] && echo "Rust project detected"
[ -f "package.json" ] && echo "Node project detected"
[ -f "next.config.js" ] || [ -f "next.config.mjs" ] && echo "Next.js detected"

# Check for Solana CLI
solana --version 2>/dev/null || echo "WARNING: Solana CLI not installed"
anchor --version 2>/dev/null || echo "WARNING: Anchor CLI not installed"

Step 2: Scaffold - Anchor Program

PROJECT_NAME="${1:-my-solana-program}"

echo "Scaffolding Anchor program: $PROJECT_NAME"

# Initialize Anchor project
anchor init "$PROJECT_NAME"
cd "$PROJECT_NAME"

# Verify structure
echo ""
echo "Project structure:"
ls -la
ls -la programs/*/src/

Step 3: Scaffold - Fullstack (Anchor + Frontend)

PROJECT_NAME="${1:-my-solana-dapp}"

echo "Scaffolding fullstack project: $PROJECT_NAME"

# Option A: Use create-solana-dapp (recommended)
if command -v npx >/dev/null 2>&1; then
    npx create-solana-dapp@latest "$PROJECT_NAME"
    cd "$PROJECT_NAME"
else
    echo "npx not available. Manual scaffold..."
    anchor init "$PROJECT_NAME"
    cd "$PROJECT_NAME"

    # Add frontend manually
    mkdir -p app
    cd app
    npx create-next-app@latest . --typescript --tailwind --eslint --app --src-dir --import-alias "@/*"
    npm install @solana/kit @solana/wallet-standard @wallet-standard/react
    cd ..
fi

echo "Fullstack project created."