open-index/open-npm huggingface dataset:
npm package: @mlw-packages/create-template
Description: Coleção de templates e um gerador interativo para iniciar projetos rapidamente.
Latest version: 1.0.8

# Grupo Malwee · templates

Coleção de templates e um gerador interativo para iniciar projetos rapidamente.

Resumo: este repositório contém templates (ex.: Next.js) e um utilitário CLI para copiar um template, ajustar o `package.json` e gerar um novo projeto pronto para desenvolvimento.

## Principais recursos

- Gerador interativo em `bin/create-template.js` para escolher template, nome, gerenciador de pacotes e extras.
- Templates prontos em `src/templates/` (ex.: Next.js, Vite + React).
- Suporte opcional a extras: Prisma, Husky, React Hook Form, Zod, Zustand e Docker.

## Requisitos

- Node.js 18+ instalado
- Gerenciador de pacotes: `pnpm` (recomendado), `npm` ou `yarn`

## Instalação (no repositório)

1. Clone este repositório ou baixe os fontes.
2. Instale dependências do próprio repositório (raiz):

```bash
pnpm install
# ou
npm install
```

## Uso do gerador

O gerador interativo está em `bin/create-template.js`. Execute-o a partir da raiz:

```bash
node ./bin/create-template.js
```

O fluxo faz:

- Escolha do diretório destino (root ou nova pasta).
- Seleção do template (ex.: Next.js).
- Escolha do gerenciador de pacotes (`pnpm`, `npm`, `yarn`).
- Seleção opcional de extras (Prisma, Docker, Husky, Hook Form, Zod, Zustand).
- Cópia dos arquivos do template para o destino e atualização do `package.json` (campo `name`).
- (Opcional) execução automática do comando de instalação no destino.

Exemplo rápido — criar no diretório atual:

```bash
# a partir da raiz do repositório
node ./bin/create-template.js
```

Ou criar em uma nova pasta `meu-app`:

```bash
node ./bin/create-template.js
# escolha "Em uma nova pasta" e informe "meu-app"
```

Após a criação, normalmente:

```bash
cd meu-app
pnpm install      # ou npm install / yarn
pnpm run dev      # iniciar modo desenvolvimento conforme o template
```

## Templates incluídos

- `src/templates/next` — Next.js (App Router, Tailwind, tRPC)
- `src/templates/vite-react` — Vite + React

Veja documentação do template Next em `src/templates/next/README.md`.

## Como adicionar um novo template

1. Crie `src/templates/<nome-do-template>` com a estrutura do projeto base.
2. Inclua um `package.json` com scripts padrão (`dev`, `build`, `start`).
3. Adicione uma opção no prompt `Template` em `bin/create-template.js` para expor o novo template.
4. Teste executando `node ./bin/create-template.js` e selecionando o template.

**Dicas**

- Mantenha templates enxutos e deixe configurações específicas (migrations, env) documentadas em um `README.md` dentro do template.

## Estrutura do repositório

- `bin/` — utilitários CLI, incluindo `bin/create-template.js`
- `src/templates/` — templates disponíveis (`next`, `vite-react`, ...)
- `package.json` — manifesto do projeto (raiz)

---

_Arquivo gerador:_ `bin/create-template.js`