🚗 Praxi — Gestión de Autoescuelas

Plataforma moderna para gestionar tu autoescuela: alumnos, profesores, clases prácticas, facturación y mucho más.

Stack Tecnológico

• Framework: Next.js 15 (App Router + TypeScript)
• Base de datos: Supabase (PostgreSQL + Auth + RLS)
• UI: shadcn/ui + Tailwind CSS v4
• Recursos UI: 21st.dev para componentes adicionales

Requisitos

• Node.js 18+
• npm 9+
• Cuenta de Supabase (free tier)

Correr en Local

# 1. Clonar el repo
git clone https://github.com/juakoasistente/praxi.git
cd praxi

# 2. Instalar dependencias
npm install

# 3. Configurar variables de entorno
cp .env.example .env.local
# Edita .env.local con tus credenciales de Supabase

# 4. Arrancar el servidor de desarrollo
npm run dev

Abre http://localhost:3000 en tu navegador.

Variables de Entorno

Variable	Descripción
NEXT_PUBLIC_SUPABASE_URL	URL de tu proyecto Supabase
NEXT_PUBLIC_SUPABASE_ANON_KEY	Clave anónima (pública) de Supabase

Estructura del Proyecto

src/
├── app/                    # Páginas y layouts (App Router)
│   ├── (auth)/             # Páginas públicas (login)
│   ├── (dashboard)/        # Páginas protegidas (gestión)
│   └── page.tsx            # Landing
├── components/
│   ├── ui/                 # Componentes shadcn/ui
│   └── [feature]/          # Componentes por feature
├── lib/                    # Utilidades, cliente Supabase, types
└── hooks/                  # Custom hooks

Ver docs/conventions.md para convenciones detalladas.

Documentación

• Convenciones del proyecto
• Decisiones de diseño
• Backlog de features

Contribuir

1. Crea una rama: feat/mi-feature o fix/mi-fix
2. Commits con Conventional Commits: feat:, fix:, docs:
3. Abre un PR con descripción clara
4. Código en inglés, UI en español

Licencia

Privado — todos los derechos reservados.