create-solana-dapp

Q: Ele fixa @solana/kit 7.0.0?

Verifique package.json gerado e atualize para 7.0.0 para corresponder à stack fixada deste guia.

Q: Onde program ID é definido?

Anchor.toml e declare_id! em programs//src/lib.rs - atualize após anchor keys sync.

Q: Como fazer deploy do scaffold?

anchor deploy contra cluster configurado após financiar keypair do deployer.

Q: Posso remover Next.js?

Sim - mantenha programs/ e testes; substitua frontend por qualquer client baseado em kit.

Q: Como configurar devnet?

Edite URL provider em Anchor.toml e env frontend NEXT_PUBLIC_RPC_URL.

Q: Quais wallet adapters estão incluídos?

Depende da flag de template - comumente @solana/wallet-adapter-react ou wallets nativas kit.

Faça scaffold de dApp Solana full-stack com programa on-chain e client Next.js usando o gerador create-solana-dapp.

Receita

Card de receita de referência rápida - pronto para copiar e colar.

pnpm create solana-dapp@latest
cd my-dapp
pnpm install
anchor build
pnpm dev

Quando usar:

Produto greenfield precisando UI conectada à wallet mais programa.
Padronizar layout de repo entre múltiplos apps Solana.
Ensinar divisão programa + client com defaults funcionais.
Pular wiring manual Next.js + Anchor.

Exemplo prático

pnpm create solana-dapp@latest my-marketplace \
  --template anchor-nextjs \
  --wallet adapter
 
cd my-marketplace
pnpm install
 
# Alinhe toolchain com pins do guia
avm use 0.32.1
anchor build
anchor test
 
# Inicie validator local + app (scripts de template variam)
pnpm dev

O que isso demonstra:

Layout monorepo ou workspace com pastas programs/ e app/.
Wallet adapter e hooks de config RPC pré-conectados.
Stub de programa Anchor 0.32.1 pronto para anchor build.

Aprofundamento

Como funciona

Gerador copia template com programa Anchor, testes e frontend Next.js.
Client usa padrões modernos de wallet (wallet-adapter ou kit específico do template).
Scripts encapsulam solana-test-validator, deploy e startup do dev server.
Você substitui instruções stub por lógica de produto incrementalmente.

Layout Típico

Caminho	Conteúdo
`programs/<name>/`	Código fonte programa Anchor
`app/` ou `src/`	Frontend Next.js
`Anchor.toml`	Program IDs e URLs de cluster
`tests/`	Testes de integração

Notas bash

# Re-execute codegen após mudanças IDL (depende do template)
anchor build
pnpm run codegen 2>/dev/null || true

Erros comuns

Versão Anchor obsoleta no template - default do gerador pode atrasar 0.32.1. Correção: atualize Anchor.toml, anchor-lang e execute avm use 0.32.1.
Assumir config devnet - template pode apontar para localnet. Correção: leia README e defina cluster provider em Anchor.toml.
Pular startup do validator - txs do client falham sem RPC. Correção: execute script validator incluso ou Surfpool.
Commitar keypairs de programa - templates incluem chaves de deploy por conveniência. Correção: rotacione para produção; gitignore secrets.
Features pesadas do template - dependências UI não usadas retardam installs. Correção: remova pacotes após scaffold se client API-only mínimo necessário.

Alternativas

Alternativa	Use quando	Não use quando
Apenas `anchor init`	Programa primeiro, client depois	Precisa UI imediata
CLI `mucho`	Templates opinativos Foundation	Arquitetura Next.js customizada
Monorepo manual	Controle total de escolhas de stack	Prazo MVP rápido
Flags mínimas create-solana-dapp	Saída mais enxuta	Aprender wiring full-stack

FAQs

Ele fixa @solana/kit 7.0.0?

Verifique package.json gerado e atualize para 7.0.0 para corresponder à stack fixada deste guia.

Posso usar npm em vez de pnpm?

Templates frequentemente documentam pnpm primeiro; npm/yarn geralmente funcionam com comandos install equivalentes.

Onde program ID é definido?

Anchor.toml e declare_id! em programs/<name>/src/lib.rs - atualize após anchor keys sync.

Como fazer deploy do scaffold?

anchor deploy contra cluster configurado após financiar keypair do deployer.

Posso remover Next.js?

Sim - mantenha programs/ e testes; substitua frontend por qualquer client baseado em kit.

Scaffold inclui testes?

Maioria dos templates inclui testes de integração Anchor - estenda com LiteSVM para velocidade unitária.

Como adicionar Tailwind ou UI kit?

Selecione variantes de template na criação ou adicione dependências pós-geração.

create-solana-dapp é oficial?

Scaffold mantido pela comunidade amplamente usado em tutoriais do ecossistema Solana - verifique repo do template para updates.

Como configurar devnet?

Edite URL provider em Anchor.toml e env frontend NEXT_PUBLIC_RPC_URL.

Quais wallet adapters estão incluídos?

Depende da flag de template - comumente @solana/wallet-adapter-react ou wallets nativas kit.

Relacionados

Visão Geral da Toolchain - ferramentas necessárias
Mucho CLI - caminho scaffold alternativo
solana-test-validator - RPC local
Noções Básicas do Anchor - estrutura de programa

Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.

Receita

Card de receita de referência rápida - pronto para copiar e colar.

pnpm create solana-dapp@latest
cd my-dapp
pnpm install
anchor build
pnpm dev

Quando usar:

Produto greenfield precisando UI conectada à wallet mais programa.
Padronizar layout de repo entre múltiplos apps Solana.
Ensinar divisão programa + client com defaults funcionais.
Pular wiring manual Next.js + Anchor.

Exemplo prático

pnpm create solana-dapp@latest my-marketplace \
  --template anchor-nextjs \
  --wallet adapter
 
cd my-marketplace
pnpm install
 
# Alinhe toolchain com pins do guia
avm use 0.32.1
anchor build
anchor test
 
# Inicie validator local + app (scripts de template variam)
pnpm dev

O que isso demonstra:

Layout monorepo ou workspace com pastas programs/ e app/.
Wallet adapter e hooks de config RPC pré-conectados.
Stub de programa Anchor 0.32.1 pronto para anchor build.

Aprofundamento

Como funciona

Gerador copia template com programa Anchor, testes e frontend Next.js.
Client usa padrões modernos de wallet (wallet-adapter ou kit específico do template).
Scripts encapsulam solana-test-validator, deploy e startup do dev server.
Você substitui instruções stub por lógica de produto incrementalmente.

Layout Típico

Caminho	Conteúdo
`programs/<name>/`	Código fonte programa Anchor
`app/` ou `src/`	Frontend Next.js
`Anchor.toml`	Program IDs e URLs de cluster
`tests/`	Testes de integração

Notas bash

# Re-execute codegen após mudanças IDL (depende do template)
anchor build
pnpm run codegen 2>/dev/null || true

Erros comuns

Versão Anchor obsoleta no template - default do gerador pode atrasar 0.32.1. Correção: atualize Anchor.toml, anchor-lang e execute avm use 0.32.1.
Assumir config devnet - template pode apontar para localnet. Correção: leia README e defina cluster provider em Anchor.toml.
Pular startup do validator - txs do client falham sem RPC. Correção: execute script validator incluso ou Surfpool.
Commitar keypairs de programa - templates incluem chaves de deploy por conveniência. Correção: rotacione para produção; gitignore secrets.
Features pesadas do template - dependências UI não usadas retardam installs. Correção: remova pacotes após scaffold se client API-only mínimo necessário.

Alternativas

Alternativa	Use quando	Não use quando
Apenas `anchor init`	Programa primeiro, client depois	Precisa UI imediata
CLI `mucho`	Templates opinativos Foundation	Arquitetura Next.js customizada
Monorepo manual	Controle total de escolhas de stack	Prazo MVP rápido
Flags mínimas create-solana-dapp	Saída mais enxuta	Aprender wiring full-stack

FAQs

Ele fixa @solana/kit 7.0.0?

Verifique package.json gerado e atualize para 7.0.0 para corresponder à stack fixada deste guia.

Posso usar npm em vez de pnpm?

Templates frequentemente documentam pnpm primeiro; npm/yarn geralmente funcionam com comandos install equivalentes.

Onde program ID é definido?

Anchor.toml e declare_id! em programs/<name>/src/lib.rs - atualize após anchor keys sync.

Como fazer deploy do scaffold?

anchor deploy contra cluster configurado após financiar keypair do deployer.

Posso remover Next.js?

Sim - mantenha programs/ e testes; substitua frontend por qualquer client baseado em kit.

Scaffold inclui testes?

Maioria dos templates inclui testes de integração Anchor - estenda com LiteSVM para velocidade unitária.

Como adicionar Tailwind ou UI kit?

Selecione variantes de template na criação ou adicione dependências pós-geração.

create-solana-dapp é oficial?

Scaffold mantido pela comunidade amplamente usado em tutoriais do ecossistema Solana - verifique repo do template para updates.

Como configurar devnet?

Edite URL provider em Anchor.toml e env frontend NEXT_PUBLIC_RPC_URL.

Quais wallet adapters estão incluídos?

Depende da flag de template - comumente @solana/wallet-adapter-react ou wallets nativas kit.

Relacionados

Visão Geral da Toolchain - ferramentas necessárias
Mucho CLI - caminho scaffold alternativo
solana-test-validator - RPC local
Noções Básicas do Anchor - estrutura de programa

Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.

create-solana-dapp

Buscar na documentação

create-solana-dapp