@atnexuslab/create-app

CLI interativo para criar projetos production-ready com os boilerplates da ATNexusLab.

Uso

npx @atnexuslab/create-app

O CLI guia você passo a passo com perguntas encadeadas baseadas no tipo de projeto:

🚀 @atnexuslab/create-app

? Qual o nome do projeto?        my-app
? Qual tipo de projeto?           Backend / Frontend / Fullstack / Mobile
? Qual framework de API?          Express / ElysiaJS / Flask / FastAPI / Django
? Banco de dados?                 Nenhum / PostgreSQL / MySQL / MongoDB
? ORM?                            Nenhum / Prisma / Drizzle / SQLAlchemy
? Cache?                          Nenhum / Redis
? Qual gerenciador de pacotes?    npm / bun / pnpm / yarn / pip / poetry / uv
? Qual linter/formatter?          Prettier + ESLint / Biome / Ruff
? Incluir autenticação?           Sim / Não
? Incluir Docker?                 Sim / Não
? Incluir GitHub Actions CI?      Sim / Não

As opções são filtradas automaticamente — por exemplo:

• Python (Flask/FastAPI/Django): ORM mostra SQLAlchemy, linter é Ruff, PM é pip/poetry/uv
• JS/TS (Express/ElysiaJS): ORM mostra Prisma/Drizzle, linter é ESLint+Prettier/Biome
• Django: pula a pergunta de ORM (usa o próprio)
• MongoDB + Drizzle: combinação não oferecida (sem suporte)

Após a criação, o CLI automaticamente:

• Inicializa um repositório git com commit inicial
• Oferece instalação de dependências (JS/TS)
• Mostra os próximos passos

CLI Options

npx @atnexuslab/create-app --help     # Exibe ajuda
npx @atnexuslab/create-app --version  # Exibe versão

Frameworks Disponíveis

Backend (API)

| Framework | Linguagem | Package Managers | Auth | Docker | |-----------|------------|-------------------|-----------------|--------| | Express | TypeScript | npm/bun/pnpm/yarn | Better Auth | ✓ | | ElysiaJS | TypeScript | bun | Better Auth | ✓ | | Flask | Python | pip/poetry/uv | Flask-Login | ✓ | | FastAPI | Python | pip/poetry/uv | FastAPI Security| ✓ | | Django | Python | pip/poetry/uv | Django Auth | ✓ |

Frontend (Web)

| Framework | Package Managers | Docker | |---------------|-------------------|--------| | React + Vite | npm/bun/pnpm/yarn | ✓ | | Vue + Vite | npm/bun/pnpm/yarn | ✓ | | Next.js | npm/bun/pnpm/yarn | ✓ | | Vinext | npm/bun/pnpm/yarn | ✓ |

Mobile

| Framework | Package Managers | |---------------|-------------------| | Flutter | (Dart/Flutter CLI) | | React Native | npm/bun/pnpm/yarn |

Banco de Dados + ORM

| Database | JS/TS ORMs | Python ORM | Docker Service | |-----------|----------------|-------------|----------------| | PostgreSQL | Prisma, Drizzle | SQLAlchemy | postgres:16 | | MySQL | Prisma, Drizzle | SQLAlchemy | mysql:8 | | MongoDB | Prisma | — | mongo:7 |

Cache

| Cache | JS/TS | Python | Docker Service | |-------|---------------|---------|----------------| | Redis | ioredis | redis | redis:7 |

O que vem incluso

Backend JS/TS (Express, ElysiaJS)

Estrutura modular production-ready:

src/
├── server.ts           # HTTP server + graceful shutdown
├── app.ts              # App config (middlewares, routes)
├── config/
│   └── env.ts          # Environment variables tipadas
├── routes/
│   ├── index.ts        # Router principal
│   └── health.ts       # GET /health
├── middlewares/
│   ├── error-handler.ts
│   └── not-found.ts
└── lib/
    └── logger.ts

Inclui: .env.example, CORS, Helmet, compression, health check, graceful shutdown, error handling centralizado.

Backend Python (Flask, FastAPI, Django)

Estrutura modular com separação server/app:

src/
├── server.py           # Entry point (gunicorn/uvicorn)
├── app.py              # App factory / FastAPI instance
├── config/
│   └── settings.py     # Settings via dataclass/Pydantic/Django
├── routes/
│   └── health.py       # GET /health
└── lib/
    └── logger.py       # Logging configurado

Django usa estrutura própria com config/ (settings, urls, wsgi, asgi) e apps/.

Inclui: .env.example, CORS, health check, structured logging, error handling.

Frontend (React, Vue)

• Path alias @/ configurado (Vite + TypeScript)
• .env.example com variáveis Vite
• Meta tags SEO e favicon
• Error Boundary (React)

Fullstack (Next.js, Vinext)

• .env.example
• Páginas de erro customizadas (error.tsx, not-found.tsx)
• Next.js com output: "standalone" e poweredByHeader: false

Fullstack (combinação Backend + Frontend)

Quando o tipo é Fullstack, o CLI pergunta tanto o backend quanto o frontend e gera um monorepo:

my-app/
├── apps/
│   ├── api/       # Backend (Express/Flask/etc)
│   └── web/       # Frontend (React/Vue/etc)
├── .editorconfig
├── .gitignore
├── package.json   # Workspaces (JS/TS)
└── README.md

Mobile (Flutter, React Native)

O CLI também suporta projetos mobile. Quando a plataforma é both (web + mobile), gera monorepo com apps/web/ e apps/mobile/.

Todos os templates

• .editorconfig com padrões consistentes (2 spaces JS/TS, 4 spaces Python)
• .gitignore com .env* patterns
• TypeScript strict mode (JS/TS)
• README com instruções de setup

Tooling

Linting & Formatação

• Prettier + ESLint — Combo tradicional (JS/TS)
• Biome — Linter + formatter all-in-one (JS/TS)
• Ruff — Linter + formatter para Python (auto-selecionado)

Autenticação

• Better Auth — Para frameworks JS/TS (Express, ElysiaJS)
• Flask-Login — Para Flask
• FastAPI Security — JWT + OAuth2 para FastAPI
• Django Auth — Custom User model para Django

Infraestrutura

• Docker — Dockerfile otimizado + docker-compose com healthcheck e restart policy
• Docker Compose — Gera automaticamente serviços de DB e cache quando selecionados
• GitHub Actions CI — Workflow com detecção automática de package manager

Desenvolvimento

git clone https://github.com/ATNexusLab/boilerplates.git
cd boilerplates
npm install
npm run build
node dist/index.js

Licença

MIT © NCC - Nexus Computer Club