ar-saas 0.2.1 → 0.3.1

package/README.md

@@ -1,13 +1,16 @@
 # ar-saas
 
+<p align="center">
+  <img src="assets/logo.png" alt="ar-saas" width="400" />
+</p>
+
 <p align="center">
   <strong>Generador de proyectos SaaS multi-tenant para startups argentinas</strong><br/>
-  Backend NestJS + Frontend Next.js listos para producción en minutos.
+  Backend NestJS + Frontend Next.js completo — landing, auth, dashboard y legal listos para producción.
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/ar-saas"><img src="https://img.shields.io/npm/v/ar-saas.svg" alt="npm version" /></a>
-  <a href="https://www.npmjs.com/package/ar-saas"><img src="https://img.shields.io/npm/dm/ar-saas.svg" alt="npm downloads" /></a>
   <a href="https://github.com/ignaciobecher/ar-saas/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license" /></a>
   <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen" alt="node version" />
 </p>
@@ -20,7 +23,7 @@
 npx ar-saas mi-proyecto
 ```
 
-Respondés 4 preguntas y en minutos tenés un proyecto completo corriendo localmente.
+Respondés algunas preguntas y en minutos tenés un proyecto completo corriendo localmente.
 
 ---
 
@@ -28,30 +31,86 @@ Respondés 4 preguntas y en minutos tenés un proyecto completo corriendo localm
 
 ```
 mi-proyecto/
-├── backend/                    # NestJS 11 + MongoDB
+├── backend/                          # NestJS 11 + MongoDB
 │   ├── src/
 │   │   ├── modules/
-│   │   │   ├── auth/           # Auth completo (JWT en cookies HttpOnly)
-│   │   │   ├── users/          # Usuarios con roles
-│   │   │   ├── workspaces/     # Multi-tenancy por workspace
-│   │   │   └── mail/           # Emails transaccionales con Resend
-│   │   └── common/             # Guards, filtros, decoradores, base repository
-│   ├── .env.example
+│   │   │   ├── auth/                 # Auth completo (JWT + GitHub OAuth en cookies HttpOnly)
+│   │   │   ├── users/                # Usuarios con roles
+│   │   │   ├── workspaces/           # Multi-tenancy por workspace
+│   │   │   └── mail/                 # Emails transaccionales con Resend
+│   │   └── common/                   # Guards, filtros, decoradores, base repository
+│   ├── .env                          # Copiado de .env.example automáticamente
 │   └── package.json
-├── frontend/                   # Next.js 15 + Tailwind CSS 4 + shadcn/ui
+│
+├── frontend/                         # Next.js 15 + Tailwind CSS 4 + shadcn/ui
 │   ├── src/
+│   │   ├── config/
+│   │   │   └── site.ts               # ← Personalización central del SaaS
 │   │   ├── app/
-│   │   │   ├── (auth)/         # Login, register, verify email, reset password
-│   │   │   ├── (dashboard)/    # Rutas protegidas con layout
-│   │   │   └── setup/          # Pantalla de onboarding al abrir por primera vez
-│   │   ├── providers/          # AuthProvider con estado global
-│   │   └── lib/api/            # Cliente axios con refresh automático
+│   │   │   ├── page.tsx              # Landing page completa
+│   │   │   ├── (auth)/               # Login, register (+términos), verify, reset
+│   │   │   ├── (dashboard)/          # Rutas protegidas
+│   │   │   │   ├── dashboard/        # Overview con stat cards
+│   │   │   │   ├── profile/          # Perfil de usuario + cambio de contraseña
+│   │   │   │   ├── settings/         # Notificaciones, workspace, zona peligrosa
+│   │   │   │   ├── billing/          # Plan actual, historial, upgrade
+│   │   │   │   └── team/             # Miembros + invitaciones
+│   │   │   ├── (legal)/
+│   │   │   │   ├── terms/            # Términos y condiciones
+│   │   │   │   └── privacy/          # Política de privacidad
+│   │   │   └── setup/                # Onboarding inicial
+│   │   ├── components/
+│   │   │   ├── landing/              # Navbar, Hero, Features, Pricing, FAQ, Footer
+│   │   │   ├── dashboard/            # Sidebar, Header, StatCard
+│   │   │   └── ui/                   # 15+ componentes shadcn/ui
+│   │   ├── providers/                # AuthProvider con estado global
+│   │   └── lib/api/                  # Cliente axios con refresh automático
+│   ├── .env.local                    # Copiado de .env.local.example automáticamente
 │   └── package.json
+│
 └── railway.toml / fly.toml / docker-compose.yml
 ```
 
 ---
 
+## Personalización
+
+Al generar el proyecto, el CLI pregunta el nombre, tagline, descripción y email de soporte del SaaS. Esos valores se inyectan automáticamente en un único archivo:
+
+```
+frontend/src/config/site.ts
+```
+
+Ese archivo es la **fuente de verdad** para todo el contenido de la app:
+
+```ts
+export const siteConfig = {
+  name: 'Mi SaaS',
+  tagline: 'La plataforma que tu equipo necesita',
+  description: 'Automatizá tu negocio...',
+  supportEmail: 'hola@mi-saas.com',
+
+  // Navegación de la landing
+  nav: { links: [...] },
+
+  // Secciones de la landing
+  hero: { headline, description, cta, ctaSecondary },
+  features: [...],     // Íconos, títulos y descripciones
+  pricing: [...],      // 3 tiers con features, precios y CTAs
+  faq: [...],          // Preguntas y respuestas
+
+  // Footer
+  footer: { columns, social, copyright },
+
+  // Usado en /terms y /privacy
+  legal: { companyName, email, lastUpdated },
+}
+```
+
+Editás ese archivo una sola vez y toda la app (landing, footer, páginas legales) queda actualizada.
+
+---
+
 ## Stack
 
 ### Backend
@@ -60,6 +119,7 @@ mi-proyecto/
 | NestJS | 11 | Framework principal |
 | MongoDB + Mongoose | 9 | Base de datos |
 | JWT (passport) | — | Autenticación en cookies HttpOnly |
+| passport-github2 | — | OAuth con GitHub |
 | Resend | — | Emails transaccionales |
 | Swagger | — | Documentación automática en `/api/docs` |
 
@@ -68,31 +128,44 @@ mi-proyecto/
 |---|---|---|
 | Next.js | 15 | App Router, Server Components |
 | Tailwind CSS | 4 | Estilos |
-| shadcn/ui | — | Componentes UI |
-| react-hook-form | — | Formularios |
+| shadcn/ui + Radix UI | — | 15+ componentes listos (button, dialog, dropdown, tabs, accordion, avatar, switch, etc.) |
+| react-hook-form | — | Formularios con validación |
 | axios | — | HTTP client con interceptor de refresh |
+| lucide-react | — | Íconos |
 
 ---
 
 ## Módulos incluidos
 
-### Free (siempre incluidos)
+### Frontend — siempre incluido
+
+| Sección | Contenido |
+|---|---|
+| **Landing page** | Navbar sticky, Hero con mockup, Features (6 cards), Pricing (3 tiers), FAQ (acordeón), CTA final, Footer |
+| **Auth** | Login, Register (con checkbox de términos), Verify email, Forgot password, Reset password |
+| **Dashboard** | Overview con stat cards, sidebar con navegación activa, header con avatar + dropdown |
+| **Perfil** | Editar nombre/email, cambiar contraseña (modal), zona de eliminación de cuenta |
+| **Ajustes** | Switches de notificaciones por email, configuración de workspace, zona peligrosa |
+| **Facturación** | Plan actual, método de pago, historial de facturas, botón de upgrade |
+| **Equipo** | Lista de miembros, invitar por email (modal), gestión de roles |
+| **Legal** | Términos y condiciones, Política de privacidad — ambas enlazadas desde el footer y el register |
+
+### Backend — siempre incluido
 
 | Módulo | Descripción |
 |---|---|
 | **Auth completo** | Registro, login, verificación de email, reset de password |
+| **GitHub OAuth** | Login/registro con GitHub (código de intercambio + cookies HttpOnly) |
 | **Multi-tenancy** | Aislamiento estricto por `workspaceId` en todas las queries |
 | **Mail transaccional** | Verificación, bienvenida y reset con Resend. Fail-open si Resend falla |
 
-### Opcionales
+### Módulos opcionales
 
 | Módulo | Descripción |
 |---|---|
-| **OAuth + 2FA** | Login con GitHub/Google + autenticación de dos factores TOTP |
 | **Notificaciones** | Notificaciones in-app + Push Web (VAPID) |
 | **Invoices + Quotes** | Facturación con generación de PDF |
 | **CRM** | Kanban + Pipeline de ventas |
-| **MercadoPago** | Suscripciones recurrentes con webhooks |
 
 ---
 
@@ -111,6 +184,10 @@ Al ejecutar el CLI se copian automáticamente los archivos `.env.example` → `.
 | `RESEND_FROM_EMAIL` | Email remitente verificado en Resend |
 | `APP_URL` | URL del frontend (para links en emails) |
 | `CORS_ORIGINS` | URL del frontend separada por comas |
+| `FRONTEND_URL` | URL del frontend para redirecciones OAuth |
+| `GITHUB_CLIENT_ID` | Client ID de tu GitHub OAuth App |
+| `GITHUB_CLIENT_SECRET` | Client Secret de tu GitHub OAuth App |
+| `GITHUB_CALLBACK_URL` | Callback URL registrada en GitHub |
 
 ### Frontend — variables requeridas
 
@@ -165,10 +242,12 @@ npm run start:dev
 cd mi-proyecto/frontend
 npm install
 npm run dev
-# → http://localhost:3001
+# → http://localhost:3001 (landing page)
+# → http://localhost:3001/login
+# → http://localhost:3001/dashboard
 ```
 
-La primera vez que abrís el frontend aparece una pantalla de onboarding que guía la configuración completa.
+La landing page aparece directo en `/`. El primer setup del backend se hace desde la pantalla de onboarding.
 
 ---
 
@@ -182,6 +261,9 @@ La primera vez que abrís el frontend aparece una pantalla de onboarding que gu
 - `POST /api/auth/forgot-password` — Solicitud de reset
 - `POST /api/auth/reset-password` — Reset de contraseña
 - `GET  /api/auth/me` — Datos del usuario autenticado
+- `GET  /api/auth/github` — Inicia el flujo OAuth con GitHub
+- `GET  /api/auth/github/callback` — Callback de GitHub
+- `POST /api/auth/github/exchange` — Canjea el código por cookies de sesión
 
 Los tokens JWT viajan **únicamente en cookies HttpOnly**. Nunca en `localStorage` ni en el body de las respuestas.
 
@@ -223,7 +305,7 @@ El código generado incluye dependencias de terceros (NestJS, Next.js, MongoDB,
 
 **Seguridad**
 
-Si encontrás una vulnerabilidad de seguridad en esta herramienta, por favor reportala abriendo un issue en el [repositorio de GitHub](https://github.com/ignaciobecher/ar-saas) en lugar de hacerlo público. Intentaremos resolverlo a la brevedad.
+Si encontrás una vulnerabilidad de seguridad en esta herramienta, por favor reportala abriendo un issue en el [repositorio de GitHub](https://github.com/ignaciobecher/ar-saas) en lugar de hacerlo público.
 
 ---
 

package/dist/cli.js

@@ -13,7 +13,7 @@ async function runCli(defaultName) {
         {
             type: 'input',
             name: 'projectName',
-            message: 'Nombre del proyecto:',
+            message: 'Nombre del proyecto (slug):',
             default: defaultName ?? 'my-saas',
             validate: (input) => {
                 if (!/^[a-z0-9][a-z0-9-]{1,}$/.test(input)) {
@@ -22,6 +22,38 @@ async function runCli(defaultName) {
                 return true;
             },
         },
+        {
+            type: 'input',
+            name: 'siteTitle',
+            message: 'Nombre del SaaS (cómo se muestra a los usuarios):',
+            default: (answers) => answers.projectName
+                ? answers.projectName
+                    .split('-')
+                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+                    .join(' ')
+                : 'Mi SaaS',
+            validate: (input) => input.trim().length >= 2 || 'El nombre debe tener al menos 2 caracteres',
+        },
+        {
+            type: 'input',
+            name: 'siteTagline',
+            message: 'Tagline (frase corta que describe el producto):',
+            default: 'La plataforma que tu equipo necesita',
+            validate: (input) => input.trim().length >= 5 || 'El tagline debe tener al menos 5 caracteres',
+        },
+        {
+            type: 'input',
+            name: 'siteDescription',
+            message: 'Descripción (una o dos oraciones para la landing):',
+            default: 'Automatizá tu negocio, escalá tu equipo y enfocate en lo que importa. Todo desde una sola plataforma.',
+        },
+        {
+            type: 'input',
+            name: 'supportEmail',
+            message: 'Email de soporte / contacto:',
+            default: (answers) => `hola@${answers.projectName ?? 'mi-saas'}.com`,
+            validate: (input) => /\S+@\S+\.\S+/.test(input) || 'Ingresá un email válido',
+        },
         {
             type: 'list',
             name: 'stack',

package/dist/generator.js

@@ -65,13 +65,16 @@ async function generate(config) {
     spinner.text = 'Configurando variables de entorno...';
     setupEnvFiles(projectDir, config);
     spinner.succeed(chalk_1.default.green(`Proyecto ${chalk_1.default.bold(config.projectName)} creado`));
+    console.log();
+    console.log(chalk_1.default.cyan(`  Sitio: ${chalk_1.default.bold(config.siteTitle)}`));
+    console.log(chalk_1.default.gray(`  "${config.siteTagline}"`));
     printNextSteps(config);
 }
 function processDir(dir, config) {
     for (const file of collectTextFiles(dir)) {
         try {
             let content = fs_1.default.readFileSync(file, 'utf-8');
-            content = applyNameReplacements(content, config.projectName);
+            content = applyNameReplacements(content, config);
             fs_1.default.writeFileSync(file, content, 'utf-8');
         }
         catch {
@@ -97,11 +100,16 @@ function collectTextFiles(dir) {
     }
     return result;
 }
-function applyNameReplacements(content, projectName) {
+function applyNameReplacements(content, config) {
+    const { projectName, siteTitle, siteTagline, siteDescription, supportEmail } = config;
     return content
         .replace(/ar-saas-backend/g, `${projectName}-backend`)
         .replace(/ar-saas-frontend/g, `${projectName}-frontend`)
-        .replace(/ar-saas/g, projectName);
+        .replace(/ar-saas/g, projectName)
+        .replace(/__SITE_NAME__/g, siteTitle)
+        .replace(/__SITE_TAGLINE__/g, siteTagline)
+        .replace(/__SITE_DESCRIPTION__/g, siteDescription)
+        .replace(/__SUPPORT_EMAIL__/g, supportEmail);
 }
 function generateDeployConfig(projectDir, config) {
     if (config.deployTarget === 'later')
@@ -222,6 +230,7 @@ function printNextSteps(config) {
         console.log();
         console.log(chalk_1.default.cyan(`  cd ${config.projectName}/frontend`));
         console.log(chalk_1.default.gray('  # Completar .env.local con la URL del backend'));
+        console.log(chalk_1.default.gray('  # Personalizar contenido en src/config/site.ts'));
         console.log(chalk_1.default.cyan('  npm install'));
         console.log(chalk_1.default.cyan('  npm run dev'));
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ar-saas",
-  "version": "0.2.1",
-  "description": "Generador de proyectos SaaS multi-tenant para startups argentinas",
+  "version": "0.3.1",
+  "description": "Generador de proyectos SaaS multi-tenant para startups argentinas. Landing page, auth, dashboard y legal listos para producción.",
   "main": "dist/index.js",
   "bin": {
     "ar-saas": "dist/index.js"
@@ -23,7 +23,11 @@
     "argentina",
     "cli",
     "generator",
-    "multi-tenant"
+    "multi-tenant",
+    "landing-page",
+    "dashboard",
+    "boilerplate",
+    "starter"
   ],
   "author": "ignacio.becher@gmail.com",
   "license": "MIT",

package/templates/frontend/package.json

@@ -9,32 +9,40 @@
     "lint": "next lint"
   },
   "dependencies": {
-    "next": "^15.3.3",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
-    "axios": "^1.7.9",
-    "js-cookie": "^3.0.5",
-    "@radix-ui/react-slot": "^1.1.2",
+    "@hookform/resolvers": "^3.9.1",
+    "@radix-ui/react-accordion": "^1.2.13",
+    "@radix-ui/react-avatar": "^1.1.12",
+    "@radix-ui/react-checkbox": "^1.3.4",
+    "@radix-ui/react-dialog": "^1.1.16",
+    "@radix-ui/react-dropdown-menu": "^2.1.17",
     "@radix-ui/react-label": "^2.1.2",
+    "@radix-ui/react-separator": "^1.1.9",
+    "@radix-ui/react-slot": "^1.1.2",
+    "@radix-ui/react-switch": "^1.3.0",
+    "@radix-ui/react-tabs": "^1.1.14",
     "@radix-ui/react-toast": "^1.2.6",
+    "axios": "^1.7.9",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "tailwind-merge": "^2.6.0",
+    "js-cookie": "^3.0.5",
     "lucide-react": "^0.477.0",
+    "next": "^15.3.3",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
     "react-hook-form": "^7.54.2",
-    "@hookform/resolvers": "^3.9.1",
+    "tailwind-merge": "^2.6.0",
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "typescript": "^5.7.3",
+    "@eslint/eslintrc": "^3.2.0",
+    "@tailwindcss/postcss": "^4.1.0",
+    "@types/js-cookie": "^3.0.6",
     "@types/node": "^22.10.7",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",
-    "@types/js-cookie": "^3.0.6",
-    "tailwindcss": "^4.1.0",
-    "@tailwindcss/postcss": "^4.1.0",
     "eslint": "^9.18.0",
     "eslint-config-next": "^15.3.3",
-    "@eslint/eslintrc": "^3.2.0"
+    "tailwindcss": "^4.1.0",
+    "typescript": "^5.7.3"
   }
 }