ar-saas 0.3.0 → 0.3.2

package/templates/backend/tsconfig.json

@@ -1,26 +1,26 @@
-{
-  "compilerOptions": {
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "resolvePackageJsonExports": true,
-    "esModuleInterop": true,
-    "isolatedModules": true,
-    "declaration": true,
-    "removeComments": true,
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "allowSyntheticDefaultImports": true,
-    "target": "ES2023",
-    "sourceMap": true,
-    "outDir": "./dist",
-    "baseUrl": "./",
-    "incremental": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "forceConsistentCasingInFileNames": true,
-    "noImplicitAny": true,
-    "strictNullChecks": true,
-    "strictBindCallApply": true,
-    "noFallthroughCasesInSwitch": true
-  }
-}
+{
+  "compilerOptions": {
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "resolvePackageJsonExports": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2023",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictBindCallApply": true,
+    "noFallthroughCasesInSwitch": true
+  }
+}

package/templates/frontend/.env.local.example

@@ -1 +1 @@
-NEXT_PUBLIC_API_URL=http://localhost:3000
+NEXT_PUBLIC_API_URL=http://localhost:3000

package/templates/frontend/README.md

@@ -0,0 +1,152 @@
+# create-saas-ar — Frontend
+
+Frontend del template SaaS para startups argentinas. Stack: Next.js 15, TypeScript, Tailwind CSS 4, shadcn/ui.
+
+---
+
+## Stack
+
+| Capa | Tecnología |
+|---|---|
+| Framework | Next.js 15 (App Router) |
+| Lenguaje | TypeScript (strict) |
+| Estilos | Tailwind CSS 4 |
+| Componentes UI | shadcn/ui |
+| Formularios | react-hook-form |
+| HTTP | axios (con interceptor de refresh automático) |
+| Auth | Cookies HttpOnly — tokens manejados por el backend |
+
+---
+
+## Prerequisitos
+
+- Node.js 20 LTS o superior
+- El backend corriendo en `http://localhost:3000` (o la URL configurada en `NEXT_PUBLIC_API_URL`)
+- MongoDB corriendo (ver instrucciones en el README del backend)
+
+---
+
+## Setup inicial
+
+### 1. Instalar dependencias
+
+```bash
+cd frontend
+npm install
+```
+
+### 2. Configurar variables de entorno
+
+```bash
+# El generador ya copió .env.local.example → .env.local automáticamente
+# Solo verificar que el valor sea correcto:
+cat .env.local
+```
+
+| Variable | Descripción | Valor por defecto |
+|---|---|---|
+| `NEXT_PUBLIC_API_URL` | URL base del backend | `http://localhost:3000` |
+
+Si cambiaste el puerto del backend, actualizá este valor.
+
+### 3. Levantar el backend primero
+
+El frontend depende del backend para autenticación. Antes de arrancar el frontend, asegurate de que el backend esté corriendo:
+
+```bash
+# En otra terminal
+cd backend
+npm run start:dev
+# Verificar: http://localhost:3000/api/docs debe cargar
+```
+
+Para levantar MongoDB antes del backend, ver las instrucciones en `backend/README.md` o ejecutar:
+
+```bash
+# Desde la raíz del proyecto
+docker compose -f docker-compose.dev.yml up -d
+```
+
+### 4. Iniciar el frontend
+
+```bash
+npm run dev
+```
+
+El frontend levanta en `http://localhost:3001`. Al abrirlo por primera vez verás la pantalla de setup con instrucciones paso a paso.
+
+---
+
+## Comandos disponibles
+
+```bash
+npm run dev          # Servidor de desarrollo con hot reload
+npm run build        # Build de producción
+npm run start        # Servidor de producción (requiere build previo)
+npm run lint         # ESLint
+```
+
+---
+
+## Estructura de carpetas
+
+```
+src/
+├── app/
+│   ├── (auth)/          # Login, registro, verificación de email, reset de contraseña
+│   ├── (dashboard)/     # Rutas protegidas (dashboard, perfil, billing, equipo)
+│   ├── (legal)/         # Términos y privacidad
+│   ├── setup/           # Pantalla de setup inicial (se muestra al arrancar por primera vez)
+│   ├── layout.tsx       # Layout raíz con AuthProvider
+│   └── page.tsx         # Redirige a /setup
+├── components/
+│   ├── landing/         # Componentes de la landing page (navbar, hero, features, pricing)
+│   ├── dashboard/       # Sidebar, header y cards del dashboard
+│   └── ui/              # Componentes shadcn/ui (no modificar directamente)
+├── config/
+│   └── site.ts          # Configuración centralizada de contenido del sitio
+├── lib/
+│   ├── api/
+│   │   ├── client.ts    # Instancia axios con interceptor de 401 → refresh automático
+│   │   └── auth.ts      # Métodos de API de autenticación
+│   └── hooks/
+│       └── use-auth.ts  # Hook para acceder al estado de auth
+├── providers/
+│   └── auth-provider.tsx # Contexto global de auth (login, logout, register, estado)
+└── types/               # Interfaces TypeScript (User, Workspace, ApiError, etc.)
+```
+
+---
+
+## Personalizar el contenido del sitio
+
+Todo el contenido de la landing page (nombre, tagline, features, precios, FAQ) está centralizado en [`src/config/site.ts`](src/config/site.ts).
+
+Los valores con formato `__PLACEHOLDER__` son reemplazados automáticamente por el generador al crear el proyecto. Para personalizarlos manualmente:
+
+```typescript
+// src/config/site.ts
+export const siteConfig = {
+  name: 'Mi SaaS',
+  tagline: 'La descripción corta de tu producto',
+  description: 'Descripción larga para SEO',
+  supportEmail: 'soporte@midominio.com',
+  // ... pricing, features, FAQ, etc.
+}
+```
+
+---
+
+## Rutas protegidas
+
+Las rutas bajo `(dashboard)/` requieren autenticación. Si el usuario no está logueado, es redirigido a `/login` automáticamente (manejado en el layout del grupo, sin middleware).
+
+Para agregar nuevas rutas protegidas, crear la carpeta dentro de `src/app/(dashboard)/`.
+
+---
+
+## Autenticación
+
+- Tokens JWT en cookies HttpOnly — el frontend nunca lee ni guarda tokens.
+- `useAuth()` expone `user`, `isAuthenticated`, `isLoading`, `login()`, `logout()`, `register()`.
+- El cliente axios renueva el access token automáticamente cuando recibe un 401.

package/templates/frontend/components.json

@@ -1,20 +1,20 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "default",
-  "rsc": true,
-  "tsx": true,
-  "tailwind": {
-    "config": "",
-    "css": "src/app/globals.css",
-    "baseColor": "slate",
-    "cssVariables": true
-  },
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  },
-  "iconLibrary": "lucide"
-}
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "slate",
+    "cssVariables": true
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

package/templates/frontend/eslint.config.mjs

@@ -1,14 +1,14 @@
-import { dirname } from 'path'
-import { fileURLToPath } from 'url'
-import { FlatCompat } from '@eslint/eslintrc'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-
-const compat = new FlatCompat({ baseDirectory: __dirname })
-
-const eslintConfig = [
-  ...compat.extends('next/core-web-vitals', 'next/typescript'),
-]
-
-export default eslintConfig
+import { dirname } from 'path'
+import { fileURLToPath } from 'url'
+import { FlatCompat } from '@eslint/eslintrc'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const compat = new FlatCompat({ baseDirectory: __dirname })
+
+const eslintConfig = [
+  ...compat.extends('next/core-web-vitals', 'next/typescript'),
+]
+
+export default eslintConfig

package/templates/frontend/next.config.ts

@@ -1,5 +1,5 @@
-import type { NextConfig } from 'next'
-
-const nextConfig: NextConfig = {}
-
-export default nextConfig
+import type { NextConfig } from 'next'
+
+const nextConfig: NextConfig = {}
+
+export default nextConfig