Instalación

Crear Tu Cuenta

Empezar con Habito es rápido y simple:

1. Visitá habito.ar
2. Hacé clic en Iniciar Sesión en la navegación superior
3. Elegí Iniciar sesión con Google
4. Autorizá a Habito para acceder a tu cuenta de Google
5. Serás redirigido a tu dashboard

Configuración Inicial

Después de iniciar sesión por primera vez, vas a ver tu dashboard vacío. Acá está lo que tenés que hacer:

1. Creá Tu Primera Tarea

Empezá simple con un hábito que querés seguir:

1. Hacé clic en el botón + Nueva Tarea
2. Elegí un tipo de tarea:
   • Hábito: Acciones que se repiten (ej: "Tomar agua")
   • Diaria: Tareas programadas (ej: "Ejercicio los Lun/Mié/Vie")
   • To-Do: Tareas de una vez (ej: "Llamar al dentista")
3. Establecé la dificultad (afecta las recompensas de XP):
   • Trivial: 5 XP (tareas simples)
   • Fácil: 10 XP (esfuerzo ligero)
   • Media: 15 XP (esfuerzo moderado)
   • Difícil: 25 XP (tareas desafiantes)
4. Hacé clic en Crear

2. Completá Tu Primera Tarea

Hacé clic en el checkbox junto a tu tarea para marcarla como completa. Vas a:

• Ganar tus primeros XP
• Ver tu barra de XP aumentar
• Acercarte al Nivel 2

3. Explorá Tu Perfil

Hacé clic en tu avatar en la esquina superior derecha para ver:

• Tu nivel actual y progreso de XP
• Estado de HP (puntos de salud)
• Total de oro ganado
• Actividad reciente
• Claves API para integración MCP

Acceso Móvil

Habito es una progressive web app (PWA) que funciona genial en el celular:

iOS (Safari)

1. Visitá habito.ar en Safari
2. Tocá el botón Compartir
3. Seleccioná Agregar a Pantalla de Inicio
4. Ponele el nombre "Habito" y tocá Agregar

Android (Chrome)

1. Visitá habito.ar en Chrome
2. Tocá el menú (tres puntos)
3. Seleccioná Agregar a pantalla de inicio
4. Confirmá tocando Agregar

La app ahora se va a abrir como una aplicación nativa con:

• Experiencia de pantalla completa
• Soporte offline para ver tareas
• Notificaciones push (próximamente)
• Ícono de app en tu pantalla de inicio

Opcional: Creá un Equipo

¿Querés colaborar con amigos o colegas?

1. Navegá a Equipos en la barra lateral
2. Hacé clic en Crear Equipo
3. Ingresá un nombre de equipo (ej: "Guerreros del Fitness", "Grupo de Estudio")
4. Hacé clic en Crear
5. Compartí tu código de invitación con miembros del equipo

Los miembros del equipo pueden:

• Ver el progreso de los demás
• Completar tareas compartidas
• Competir en tablas de clasificación semanales
• Alentarse mutuamente con comentarios

Opcional: Configurá Proyectos

Para funcionalidades de gestión de proyectos:

1. Navegá a Proyectos en la barra lateral
2. Hacé clic en Crear Proyecto
3. Ingresá detalles del proyecto:
   • Nombre: Título del proyecto
   • Slug: Identificador amigable para URL (auto-generado)
   • Descripción: De qué trata este proyecto
   • Ícono y Color: Personalización visual
4. Hacé clic en Crear

Ahora podés:

• Crear issues dentro del proyecto
• Seguir el progreso con tableros Kanban
• Asignar issues a miembros del equipo
• Establecer prioridades y etiquetas
• Agregar comentarios y bloqueadores

Configuración del Entorno (Para Desarrolladores)

Si estás haciendo self-hosting o contribuyendo a Habito:

# Clonar el repositorio
git clone https://github.com/your-org/habito.git
cd habito

# Instalar dependencias
npm install

# Configurar variables de entorno
cp .env.example .env
# Editá .env con tu URL de base de datos y credenciales OAuth

# Ejecutar migraciones de base de datos
npm run db:migrate

# Iniciar servidor de desarrollo
npm run dev

# Clonar el repositorio
git clone https://github.com/your-org/habito.git
cd habito

# Instalar dependencias
pnpm install

# Configurar variables de entorno
cp .env.example .env
# Editá .env con tu URL de base de datos y credenciales OAuth

# Ejecutar migraciones de base de datos
pnpm db:migrate

# Iniciar servidor de desarrollo
pnpm dev

# Clonar el repositorio
git clone https://github.com/your-org/habito.git
cd habito

# Instalar dependencias
bun install

# Configurar variables de entorno
cp .env.example .env
# Editá .env con tu URL de base de datos y credenciales OAuth

# Ejecutar migraciones de base de datos
bun db:migrate

# Iniciar servidor de desarrollo
bun dev

Variables de Entorno Requeridas

# Base de datos
DATABASE_URL=postgresql://usuario:contraseña@localhost:5432/habito

# Google OAuth
GOOGLE_CLIENT_ID=tu-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=tu-client-secret

# Encriptación de sesión
NUXT_SESSION_PASSWORD=al-menos-32-caracteres-de-largo

# URL pública
NUXT_PUBLIC_SITE_URL=https://habito.ar

Próximos Pasos

Ahora que estás configurado, aprendé cómo usar Habito efectivamente:

• Guía de Uso - Aprendé lo básico
• Tipos de Tareas - Entendé hábitos, diarias y to-dos
• Gamificación - Dominá el sistema de XP y niveles
• Integración MCP - Conectá asistentes de IA