Sprint Hub - Gemini Guidelines
Defines tech stack, directory structure, development patterns, and common commands for a Next.js project called Sprint Hub.
What this file does
Defines tech stack, directory structure, development patterns, and common commands for a Next.js project called Sprint Hub.
When to use it
- Onboarding a new developer to the Sprint Hub project
- Setting up a new Next.js project with similar stack choices
- Establishing coding conventions for a team using Prisma and Shadcn UI
Assumes this stack
Sprint Hub - Gemini Guidelines
Este documento fornece diretrizes e contexto para o Gemini atuar no projeto Sprint Hub.
🚀 Tech Stack
- Framework: Next.js 16+ (App Router)
- Linguagem: TypeScript
- Estilização: Tailwind CSS 4 & CSS Variables
- UI Components: Shadcn UI (Radix UI)
- Ícones: Lucide React & Tabler Icons
- Banco de Dados: Prisma ORM
- Gerenciamento de Formulários: React Hook Form + Zod
- Tabelas: TanStack Table
- Drag & Drop: dnd-kit
📁 Estrutura de Diretórios
src/app: Rotas e componentes de página.(private): Rotas protegidas (admin, evaluator, startup).(public): Rotas públicas (auth/login).
src/components: Componentes React reutilizáveis.ui: Componentes base do Shadcn UI.
src/lib: Utilitários, configurações (ex:prisma.ts).prisma: Schema do banco de dados e migrações.
🛠 Padrões de Desenvolvimento
- Componentes: Utilize
lucide-reactpor padrão para ícones. Para ícones específicos não disponíveis, verifiquetabler-icons-react. - Server Components: Prefira Server Components por padrão. Use
"use client"apenas quando necessário (interatividade, hooks de estado/efeito). - Formulários: Devem ser feitos obrigatoriamente com React Hook Form e Zod para validação. Utilize a estrutura de
schema.tspróxima às páginas de formulário. - Estilização: Siga os padrões do Tailwind CSS 4. Evite CSS inline, prefira classes utilitárias.
- Prisma: Ao realizar alterações no banco, lembre-se de rodar
npx prisma generate. - Comunicação: Ao realizar tarefas notáveis ou mudanças estruturais, explique detalhadamente o plano para o usuário antes de solicitar a implementação.
🎨 Design System
- O projeto utiliza um tema dark/light controlado pelo
next-themes. - As cores são definidas via variáveis CSS no
globals.css.
📝 Comandos Comuns
npm run dev: Inicia o servidor de desenvolvimento.npm run build: Cria o build de produção.npx prisma studio: Abre a interface visual do banco de dados.npx prisma db push: Sincroniza o schema com o banco de dados (ambiente de dev).
What's inside
7 sections: tech stack, directory structure, 6 development patterns, design system, common commands.
Change this for your project
- Replace
Sprint Hubwith your project name - Replace
sprint-ct/sprint-hubwith your repository name - Replace
src/app/(private)andsrc/app/(public)with your own route groups
Where it goes
Keep it in your repository where the agent or team that needs it will read it.
Related Documents
Totem — Development Rules
Defines team-wide conventions for a pnpm monorepo: branch strategy, commit rules, tooling, and a mandatory knowledge-search workflow before coding.
MechCAD-MLLM
Proposes a MLLM + dual-decoder architecture for mechanical CAD generation, combining Drawing2CAD and CAD-GPT ideas.
Prompt Generator
Generates Stable Diffusion and Flux prompts via Qwen3-8B on Ollama, with a Gradio UI and CLI.
Agent Instructions
Defines a three-layer architecture (directive, orchestration, execution) for AI agents that self-anneal errors and update living SOPs.