StepUp 📋

Un paso. Solo uno. Ahora.

Aplicación mobile anti-procrastinación que combate la task paralysis descomponiendo cualquier tarea grande en pasos pequeños y accionables de 5 a 15 minutos. La pantalla principal muestra únicamente el próximo paso pendiente, eliminando la sensación de abrumamiento que impide arrancar.

Descripción

StepUp resuelve un problema concreto: las personas saben que tienen tareas importantes pero cuando las ven como un bloque grande, el cerebro entra en modo de evitación. Las apps de to-do list tradicionales organizan las tareas pero no reducen esa barrera cognitiva.

Cómo funciona:

El usuario carga una tarea con nombre y fecha límite opcional.
La divide manualmente en pasos de 5–15 minutos.
La app muestra solo el próximo paso, no la lista completa.
El usuario ejecuta el paso, opcionalmente con un timer.
Al completarlo, aparece el siguiente automáticamente.
Cuando todos los pasos están listos, la tarea se registra en el historial.

Estado del proyecto

Entrega 1 — Completada ✅ (Marzo – Junio 2026) App 100% offline con ciclo completo de tareas, pasos, timer e historial.

Entrega 2 — Completada ✅ (Julio – Agosto 2026) Migración visual al diseño Zenith Vitality + backend + auth + sync offline-first.

Módulo	Estado
Gestión de tareas (CRUD)	✅ Completado
División en pasos	✅ Completado
Vista Foco (próximo paso)	✅ Completado
Timer opcional por paso	✅ Completado
Completar pasos con avance automático	✅ Completado
Historial de tareas completadas	✅ Completado
Theme system + componentes UI (Zenith Vitality)	✅ Completado
Backend / sync en la nube	✅ Completado (E2)
Autenticación (JWT)	✅ Completado (E2)
Onboarding + notificaciones	✅ Completado (E2 — v1; notif. v2 priorizada a E3)
Date picker + responsive web	✅ Completado (E2)
Insignias y perfil	✅ Completado (E2)
Sugerencia de pasos con IA	⏳ Planificado para E3

Tech stack

Capa	Tecnología
Framework mobile	React Native + Expo SDK 54 (no usar SDK 55)
Lenguaje	TypeScript
Base de datos local	expo-sqlite (SQLite)
Navegación	React Navigation — GlassTabBar
Diseño visual	Sistema Zenith Vitality
Testing	Vitest (app, 111 tests) + Jest/Supertest (backend, 94 tests)
Control de versiones	Git + GitHub + Conventional Commits
Backend (E2)	Node.js + Express + Prisma + PostgreSQL + Railway

Documentación obligatoria

Antes de escribir código, leer en este orden:

Orden	Documento	Por qué
1	`docs/Contexto.md`	Contexto completo, entregas, decisiones técnicas
2	`docs/CONVENCIONES.md`	Reglas de estilo, arquitectura, git y calidad
3	`.claude/skills/zenith-vitality-ds/SKILL.md`	Design System: tokens, componentes, anti-patterns
4	`AGENTS.md`	Guía rápida para agentes de IA

Requisitos previos

Antes de correr el proyecto, asegurate de tener instalado:

Node.js v18 o superior
npm v9 o superior (viene con Node)
Expo Go en tu dispositivo Android o iOS físico
Git

Verificá las versiones:

node --version   # debe ser v18+
npm --version    # debe ser v9+
git --version

Cómo correr el proyecto

1. Clonar el repositorio

git clone https://github.com/YahirAedo/stepup.git
cd stepup

2. Instalar dependencias

npm install

3. Iniciar el servidor de desarrollo

npx expo start

Esto abre el Metro Bundler en la terminal y muestra un código QR.

4. Abrir la app

En el celular: abrí Expo Go, escaneá el QR que aparece en la terminal.

En el navegador: presioná W en la terminal.

En emulador Android: presioná A en la terminal (requiere Android Studio).

Nota: La base de datos SQLite se inicializa automáticamente al primer arranque. No requiere ninguna configuración manual.

Nota E2: Para probar registro y sincronización apuntá la app al backend (producción en Railway por defecto). Si querés correrlo local:
cd backend
npm install
docker compose up -d        # Postgres local
cp .env.example .env        # definir JWT_SECRET y DATABASE_URL
npx prisma migrate deploy
npm run dev
Y en la raíz: EXPO_PUBLIC_API_URL=http://localhost:3000 npx expo start. Para la demo con datos de ejemplo: EXPO_PUBLIC_SEED_DB=true npx expo start.

Estructura del proyecto

stepup/
├── src/
│   ├── screens/
│   │   ├── FocusScreen.tsx        # Vista Foco — próximo paso + timer
│   │   ├── TaskListScreen.tsx     # Lista de tareas activas
│   │   ├── TaskDetailScreen.tsx   # Detalle de tarea + pasos
│   │   ├── TaskFormScreen.tsx     # Crear / editar tarea
│   │   ├── StepFormScreen.tsx     # Crear / editar paso
│   │   ├── StepCompleteScreen.tsx # Celebración + confetti
│   │   ├── HistoryScreen.tsx      # Historial + gráfico semanal
│   │   ├── BadgesScreen.tsx       # Galería de insignias
│   │   ├── ProfileScreen.tsx      # Perfil y configuración
│   │   ├── BadgesScreen.tsx       # Galería de insignias
│   │   ├── OnboardingScreen.tsx    # Onboarding inicial
│   │   ├── WelcomeScreen.tsx      # Entrar con cuenta o explorar sin cuenta
│   │   ├── LoginScreen.tsx        # Inicio de sesión
│   │   ├── RegisterScreen.tsx     # Registro + migración de datos
│   │   └── SyncConflictScreen.tsx # Resolución de conflictos de sync
│   ├── services/
│   │   ├── TaskService.ts         # CRUD tareas + completado
│   │   ├── StepService.ts         # Pasos + orden + completar
│   │   ├── TimerService.ts        # Countdown / countup por paso
│   │   ├── ProgressService.ts     # Historial + contador diario
│   │   ├── api.ts                 # Cliente HTTP (JWT + idempotencia)
│   │   ├── AuthService.ts         # Registro, login, sesión
│   │   ├── SyncService.ts         # Push / pull / migrate / conflictos
│   │   ├── syncLifecycle.ts       # Sync automático al abrir/cerrar
│   │   ├── session.ts             # Persistencia de sesión
│   │   ├── idempotency.ts         # Claves idempotentes
│   │   └── dateFormat.ts          # Helpers ISO + display
│   ├── database/
│   │   ├── db.ts                  # Conexión + inicialización SQLite
│   │   └── migrations.ts          # 4 migraciones (schema + sync + conflictos + owner)
│   ├── components/                # Componentes UI reutilizables
│   │   ├── Button.tsx             # Botones primary/secondary/tertiary
│   │   ├── Card.tsx               # Contenedor tipo glassmorph
│   │   ├── Badge.tsx              # Etiquetas de estado
│   │   ├── TextField.tsx          # Input con label
│   │   ├── ProgressBar.tsx        # Barra de progreso
│   │   ├── ProgressRing.tsx       # Anillo SVG de progreso
│   │   ├── StepItem.tsx           # Item de paso con checkbox
│   │   ├── TimerWidget.tsx        # Display del timer
│   │   ├── GlassTabBar.tsx        # Barra inferior flotante
│   │   ├── EmptyState.tsx         # Estado vacío con CTA
│   │   ├── LineChart.tsx          # Gráfico de líneas simple
│   │   └── ConfettiOverlay.tsx    # Confetti animado
│   └── theme/
│       ├── colors.ts              # Paleta de colores
│       ├── typography.ts          # Estilos de texto
│       ├── spacing.ts             # Sistema de espaciado
│       ├── borderRadius.ts        # Radios de borde
│       └── shadows.ts             # Sombras ambientales
├── .claude/skills/zenith-vitality-ds/  # Design System skill para IA
├── backend/                     # API REST (E2) — Express + Prisma + PostgreSQL
│   ├── src/
│   │   ├── server.ts            # Entry point (env fail-closed)
│   │   ├── app.ts               # Express app + rutas
│   │   ├── routes/              # auth, task, step, sync, progress
│   │   ├── controllers/         # Capa HTTP
│   │   ├── services/            # Lógica de negocio
│   │   ├── repositories/        # Acceso a datos (Prisma)
│   │   ├── middleware/          # auth, idempotency, error-handler
│   │   └── tests/               # 9 suites (94 casos)
│   ├── prisma/
│   │   ├── schema.prisma        # User, Task, Step, DailyProgress, IdempotencyKey
│   │   └── migrations/          # 4 migraciones
│   └── docker-compose.yml       # Postgres local de desarrollo
├── docs/
│   ├── CONVENCIONES.md            # Reglas del equipo
│   ├── Contexto.md                 # Contexto completo del proyecto
│   └── practicas-recomendadas.md  # Prácticas de ingeniería
├── App.tsx                        # Entry point + navegación bottom tabs
├── AGENTS.md                      # Guía para agentes de IA
├── app.json
├── tsconfig.json
└── package.json

Convenciones del equipo

Todas las reglas de estilo, arquitectura, git y calidad están en docs/CONVENCIONES.md.

Resumen rápido:

Git: main ← develop ← feature/*. Nunca commitear directo a main.
Commits: formato convencional (feat:, fix:, docs:, refactor:, test:, chore:).
Estilos: siempre usar tokens del theme, nunca colores hardcodeados.
Arquitectura: las screens no acceden a SQLite directamente.
IA: cualquier agente debe leer AGENTS.md y docs/CONVENCIONES.md antes de escribir código.

Entregas

Entrega	Período	Stack	Estado
E1	Marzo – Junio 2026	React Native + Expo + SQLite local	✅ Completada
E2	Julio – Agosto 2026	+ Node.js + PostgreSQL + Railway	✅ Completada
E3	Septiembre – Noviembre 2026	+ IA + Dashboard + Demo final	⏳ Planificado

Equipo

Proyecto universitario — Ingeniería en Sistemas de Información — 2026

Integrante	GitHub
Alejandro Aedo	@YahirAedo
Santiago Farias	@IamSantiFarias
Joaquín Arias	@joaar

StepUp — Ingeniería en Sistemas de Información — 2026

Name		Name	Last commit message	Last commit date
.claude/skills/zenith-vitality-ds		.claude/skills/zenith-vitality-ds
.github		.github
assets		assets
backend		backend
docs		docs
src		src
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.prettierrc		.prettierrc
AGENTS.md		AGENTS.md
App.tsx		App.tsx
README.md		README.md
SECURITY.md		SECURITY.md
app.json		app.json
eslint.config.js		eslint.config.js
index.ts		index.ts
metro.config.js		metro.config.js
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

Navigation Menu

Repository files navigation

StepUp 📋

Tabla de contenidos

Descripción

Estado del proyecto

Tech stack

Documentación obligatoria

Requisitos previos

Cómo correr el proyecto

1. Clonar el repositorio

2. Instalar dependencias

3. Iniciar el servidor de desarrollo

4. Abrir la app

Estructura del proyecto

Convenciones del equipo

Entregas

Equipo

About

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

StepUp 📋

Tabla de contenidos

Descripción

Estado del proyecto

Tech stack

Documentación obligatoria

Requisitos previos

Cómo correr el proyecto

1. Clonar el repositorio

2. Instalar dependencias

3. Iniciar el servidor de desarrollo

4. Abrir la app

Estructura del proyecto

Convenciones del equipo

Entregas

Equipo

About

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages