Introducción
Imansi es un ecosistema de infraestructura para developers. Te permite construir aplicaciones completas con autenticación, dashboard y diseño profesional en minutos, no en semanas.
En vez de armar desde cero el login, el panel, los componentes y el sistema de diseño, empezás con una base sólida y productiva.
¿Por qué Imansi?
Armar una aplicación moderna implica resolver siempre los mismos problemas: autenticación, recuperación de contraseña, OAuth, 2FA, dashboard, tablas, formularios, notificaciones, temas claro/oscuro, accesibilidad, diseño consistente. Es trabajo repetitivo que no diferencia tu producto.
Imansi empaqueta todo eso en un ecosistema modular, en español, con una estética minimalista y sin dependencias ocultas. Vos te enfocás en el producto, no en la infraestructura.
Los 9 paquetes del ecosistema
El ecosistema se organiza en 4 capas. Cada paquete hace una sola cosa y la hace bien.
🚀 Punto de entrada
| Paquete | Qué hace |
|---|---|
create-imansi-app | CLI oficial. Creá proyectos completos con un comando. |
🎨 Diseño
| Paquete | Qué hace |
|---|---|
@imansi/tailwind | Design tokens, 6 temas y 2 modos sobre Tailwind CSS v4. |
@imansi/ui | 40+ componentes React accesibles construidos sobre Radix UI. |
🔐 Autenticación
| Paquete | Qué hace |
|---|---|
imansi-auth-node | Servidor de autenticación para Node.js: registro, login, 2FA, OAuth, sesiones. |
imansi-auth-react | Hooks de autenticación para React. Sin componentes visuales. |
imansi-correos-node | 26 plantillas de correo en español con envío SMTP integrado. |
📄 Plantillas
| Paquete | Qué hace |
|---|---|
@imansi/templates | 29 páginas completas: landing, blog, login, dashboard y más. |
@imansi/templates-auth | 4 variantes visuales de autenticación. |
@imansi/templates-dashboard | 4 variantes visuales de dashboard. |
Cómo se conectan
create-imansi-app ← Punto de entrada (CLI)
↓
@imansi/tailwind ← Design tokens + 6 temas
↓
@imansi/ui ← Componentes React
↓
imansi-auth-react ← Hooks de autenticación
↓
@imansi/templates-auth ← Variantes visuales de auth
@imansi/templates-dashboard ← Variantes visuales de dashboard
↓
imansi-auth-node ← Backend de autenticación
imansi-correos-node ← Plantillas de correoCada capa consume la anterior sin modificarla. Podés usar solo una parte del ecosistema (por ejemplo, solo @imansi/ui con @imansi/tailwind) o todo junto.
Filosofía del ecosistema
1. Todo en español
Los nombres de funciones, las props, la documentación, las plantillas de correo. Sin mezclar idiomas. Si sos hispanohablante, vas a sentirte en casa.
2. Modular
No estás obligado a usar todo. Cada paquete es independiente y puede funcionar solo. Usá lo que necesites.
3. Sin dependencias ocultas
Nada de node_modules intocables. Los templates se copian a tu proyecto y son 100% editables. El CSS es tuyo.
4. Sistema de diseño unificado
6 temas × 2 modos (light/dark) sobre Tailwind CSS v4. Cambiar la identidad visual completa es cambiar un atributo en <html>.
5. Accesible
Todos los componentes cumplen WCAG AA. Construidos sobre Radix UI, con navegación por teclado, focus visible y ARIA correcto.
6. Open source
Licencia MIT en todos los paquetes. Inspeccioná el código, forkealo, contribuí.
¿Por dónde empezar?
Tenés tres caminos según lo que necesites:
🎯 Camino 1 — Quiero un proyecto completo (recomendado)
npx create-imansi-app@latest mi-appEl CLI te hace 7 preguntas y genera un proyecto con autenticación funcional, dashboard y todo el ecosistema configurado.
🧩 Camino 2 — Quiero componentes y diseño
Si ya tenés un proyecto y querés solo los componentes o el sistema de diseño:
npm install @imansi/tailwind @imansi/ui👉 Ver @imansi/tailwind o ver @imansi/ui
🔐 Camino 3 — Quiero solo autenticación
Si solo necesitás login, registro, 2FA y OAuth:
npm install imansi-auth-node imansi-auth-react👉 Ver imansi-auth-node o ver imansi-auth-react
Requisitos técnicos
| Herramienta | Versión mínima |
|---|---|
| Node.js | 18.0.0 |
| React | 18.0.0 (o 19) |
| Tailwind CSS | 4.0 |
| PostgreSQL | 12 (solo si usás imansi-auth-node) |
Próximo paso
👉 Ir al Quickstart — Empezá en 10 segundos