hedhog new

Cria um novo projeto HedHog a partir do template oficial.

Uso

hedhog new <project-name> [options]

O que faz

A execução de hedhog new segue esta ordem:

Clona o template oficial em uma nova pasta com o nome do projeto
Configura o ambiente inicial do projeto
Prepara o banco de dados via Docker Compose quando o fluxo padrão exige
Inicializa um repositório Git na pasta criada
Adiciona a biblioteca core do HedHog ao projeto

Opções

Flag	Descrição
`-v, --verbose`	Exibe logs detalhados
`-f, --force`	Sobrescreve uma pasta existente com o mesmo nome
`-s, --skip-install`	Ignora a instalação de dependências
`-h, --dbhost <name>`	Host do banco de dados
`-p, --dbport <number>`	Porta do banco de dados
`-u, --dbuser <name>`	Usuário do banco de dados
`-w, --dbpassword <password>`	Senha do banco de dados (obrigatória — o processo é interrompido se omitida)
`-d, --dbname <name>`	Nome do banco de dados
`-t, --dbtype <type>`	Tipo do banco de dados; o fluxo atual é focado em Postgres

Exemplos

Criar um novo projeto

hedhog new my-project

Sobrescrever uma pasta existente

hedhog new my-project --force

Ignorar a instalação de dependências

hedhog new my-project --skip-install

Fornecer parâmetros do banco de dados

hedhog new my-project -h localhost -p 5432 -u postgres -w password -d my_database -t postgres

Após criar o projeto

Quando o comando terminar, entre na pasta do projeto e continue o fluxo:

cd my-project

A partir daí, você pode usar hedhog add para incluir novos recursos e hedhog update para manter as bibliotecas atualizadas.

Fluxo inicial recomendado

# 1. Create the project
hedhog new my-project

# 2. Enter the folder
cd my-project

# 3. Add a module
hedhog add menu

# 4. Start the environment
hedhog start

Operações de manutenção

Comando	Finalidade
`hedhog dev doctor`	Verifica a consistência do `hedhog.json`
`hedhog dev doctor --fix`	Corrige automaticamente as inconsistências detectadas
`hedhog dev backupdb`	Faz backup do banco de dados antes de operações arriscadas
`hedhog dev restoredb`	Restaura um backup anterior do banco de dados

Fluxo de atualização seguro

hedhog dev backupdb
hedhog update          # or: hedhog update <library>
# validate the application
# if something goes wrong:
hedhog dev restoredb

Observações

Se a pasta já existir, use --force para removê-la e recriá-la.
O comando depende do pnpm e pode inicializar o banco de dados via Docker Compose.
Antes de gerar o scaffold, o hedhog new também verifica a presença do git e do pnpm. Quando algum deles está ausente, ele oferece instalá-los automaticamente (apenas via prompt interativo). Consulte Problemas Comuns de Instalação para entender como funciona o caminho de instalação automática via winget/npm e um caso conhecido de falha do winget/msstore.
Para o fluxo completo pós-instalação, incluindo como iniciar o projeto gerado, consulte Primeiros Passos.