generating-solana-projects

Generating Solana Projects

Goal: Create production-ready Solana blockchain projects with Anchor framework and Next.js frontend.

Workflow

1. Gather requirements: Ask user for project name, program functionality, required instructions, and frontend features
2. Generate project structure: Create complete directory tree following Anchor conventions
3. Create Rust smart contract: Generate lib.rs, state.rs, errors.rs, and instruction handlers in programs/
4. Create configuration files: Generate Anchor.toml, Cargo.toml, package.json, tsconfig.json with version 0.32.1
5. Create tests: Generate TypeScript test file with Anchor testing framework setup
6. Create Next.js frontend: Generate wallet provider setup, Anchor client, and UI components in app/
7. Provide setup instructions: Tell user to run anchor keys list, update program IDs, build, deploy, and test

Critical versions

Always use these exact versions for compatibility:

• Anchor: 0.32.1
• anchor-lang (Rust): 0.32.1
• @coral-xyz/anchor (JS): ^0.32.1
• @solana/web3.js: ^1.87.6
• Next.js: 14.0.4

Project structure template

{project-name}/
├── Anchor.toml
├── Cargo.toml (workspace)
├── package.json
├── programs/{program-name}/
│   ├── Cargo.toml
│   └── src/
│       ├── lib.rs
│       ├── state.rs
│       ├── errors.rs
│       └── instructions/
├── tests/{program-name}.ts
└── app/ (Next.js)
    ├── package.json
    └── src/
        ├── pages/_app.tsx
        ├── components/
        └── utils/anchorSetup.ts

Important reminders

After generation, user must:

1. Generate program ID: anchor keys list
2. Update program ID in three locations: Anchor.toml, lib.rs (declare_id!), anchorSetup.ts
3. Build before deploying: anchor build generates IDL and types needed by frontend

For detailed templates, code snippets, and examples, see [reference.md](reference.md) and [examples.md](examples.md).