convez.ai
SkillDesenvolvimento WebIntermediário
xinweiiiii

Claude Code — Template Next.js + FastAPI

xinweiiiii/claude-code-template-nextjs-fastapi

Setup automático com agents e skills para Next.js + FastAPI

Ver no GitHub
InicialPluginScore · de 0 a 100

Template de configuração Claude Code para projetos full-stack com Next.js e FastAPI. Inclui CLAUDE.md, agents especializados (code review, segurança, testes) e skills reutilizáveis para padrões de FastAPI, Pydantic, PostgreSQL, Redis e Docker. Fornece comandos slash para setup, PR, auditoria de segurança e quality gates automáticos.

Instalação

$npx convez-ai xinweiiiii/claude-code-template-nextjs-fastapi

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Scaffolding de novos projetos full-stack com padrões pré-configurados
  • Code review, auditoria de segurança e testes automatizados durante desenvolvimento
  • Padronização de workflows de PR e quality gates em equipes

Veredito

Template maduro e bem estruturado que acelera onboarding de projetos Next.js + FastAPI com agents de QA e segurança. Ideal para equipes que querem padrões consistentes e automação de reviews desde o início.

README

A tradução para o português deste README ainda está na fila.

Claude Code Setup — Next.js + FastAPI Template

A Claude Code configuration template for full-stack projects using Next.js and FastAPI. Drop this into your project and Claude gets safety rails, domain skills, quality-gate commands, and structured PR workflows out of the box.


How it works

Claude Code loads three layers of configuration automatically at the start of every session:

  1. CLAUDE.md — tells Claude your stack, dev commands, coding standards, and git workflow. Fill this in for your project.
  2. .claude/agents/ — specialised sub-agents Claude can spawn for focused tasks (code review, security audit, test writing, PR creation).
  3. .claude/skills/ — domain knowledge Claude loads on demand to follow project-specific patterns (FastAPI, Next.js App Router, Pydantic, Tailwind, PostgreSQL, Redis, Docker).

Hooks in .claude/settings.json run automatically on every tool call — blocking dangerous commands, linting and formatting files on save, and logging sessions.


Slash commands

Run these from any Claude Code session:

CommandWhat it does
/project-setupScaffold a new Next.js 15 + Tailwind frontend and FastAPI backend from scratch
/open-prWrite a structured PR description and open a pull request
/reviewRun a code review on the current changes
/security-auditAudit the current changes for auth gaps, injection risks, and secrets exposure
/write-testsWrite tests covering happy paths, error cases, and edge cases
/test-and-reviewFull quality gate — tests + security audit + code review in sequence

Agents

Sub-agents in .claude/agents/ are spawned automatically by the commands above, or you can invoke them directly:

AgentPurpose
code-reviewerReviews for correctness, architecture, FastAPI/Next.js best practices, and production readiness
security-auditorChecks auth, authorisation, injection vectors, secrets exposure, and unsafe data handling
test-writerWrites pytest and Playwright tests with explicit assertions and realistic test data
pr-writerProduces four-section PR descriptions: Problem, Solution, Deployment, Testing

Skills

Skills in .claude/skills/ are reference knowledge Claude uses when working in each domain:

SkillWhen it applies
fastapi-architectureREST response conventions, status codes, error schemas
pydantic-patternsPydantic v2 models, validators, serialization, settings
rest-response-standardPagination, filtering, sorting, response envelope
postgres-patternsQuery optimisation, indexing, schema design
redisData structure selection, key naming conventions
python-testingpytest patterns, fixtures, mocking, parametrization
deployment-patternsCI/CD, Docker, health checks, rollback strategies
docker-publishBuild and push frontend/backend images to ECR or Docker Hub
project-setupFull scaffold: Next.js 15 + FastAPI + PostgreSQL + Redis + Docker Compose
nextjs-app-router-fundamentalServer Actions, Route Handlers, Suspense streaming, error boundaries
nextjs-advanced-routingParallel Routes, Intercepting Routes, Server Component architecture
nextjs-anti-patternsCommon App Router mistakes to avoid
nextjs-client-cookie-patternClient component → server action cookie pattern
tailwind-cssTailwind v4 utility patterns, dark mode, responsive design

Hooks

Hooks in .claude/settings.json run automatically — no manual invocation needed:

HookTriggerWhat it does
lint-and-formatAfter every file write or editRuns ESLint + Prettier for .ts/.tsx, ruff for .py
block_dangerous.pyBefore every bash commandBlocks destructive operations (force push, rm -rf /, DROP TABLE, curl-to-shell, etc.)
session_summary.pyOn session stopAppends session metadata to .claude/session-logs/YYYY-MM-DD.log

Getting started

  1. Clone this repo into your project root
  2. Fill in CLAUDE.md with your stack, commands, and conventions
  3. Fill in docs/architecture.md and docs/design-docs.md with system context
  4. Start a Claude Code session — configuration loads automatically
Ver o original no GitHub

Bom para

Relacionados