Bienvenido a Syncro

Documentación técnica y guía de desarrollo de Syncro, la plataforma web de gestión ágil de proyectos para equipos colaborativos.

Comenzar Ver la app

Backlog y planificación

Ver el backlog completo

El backlog del proyecto usa un modelo de temas abiertos (direcciones estables, no sprints cerrados). Allí se definen los temas, el foco trimestral y las etiquetas para GitHub Issues.

🗺️ El Roadmap contiene el plan maestro: visión, alcance del MVP, decisiones técnicas y fases de evolución.

Stack tecnológico

▲ Next.js 16 — Framework full-stack (React + SSR)
◆ Turborepo — Monorepo manager
⬡ pnpm — Package manager
▤ Prisma 7 — ORM para la base de datos
TS TypeScript 5 — Tipado estricto

Primeros pasos

⚠️ La app web requiere PostgreSQL, .env y migraciones. Para la guía completa de setup, consulta el README del proyecto.

💬 ¿Necesitas las variables de entorno? Únete al Discord de Syncro.

📁 Estructura del repositorio: al clonar obtienes Syncro/syncro/... — la raíz del repositorio es la carpeta que contiene syncro/, y syncro/ es la raíz del monorepo (donde viven package.json y apps/). Los comandos de esta guía asumen que partes de la raíz del repositorio.

Solo la documentación (no requiere BD)

cd syncro
pnpm install
pnpm dev:fallback --filter=docs   # http://localhost:3001

App completa

cd syncro
pnpm install
pnpm dev:fallback   # web (:3000) + docs (:3001)

También puedes arrancar apps por separado:
Ventana de terminal
cd apps/web && pnpm run dev    # Solo la web
cd apps/docs && pnpm run dev   # Solo las docs

Quiero probar la app con datos demo 🧪

El proyecto incluye un seeder con 5 usuarios, 3 workspaces y 40 tareas de backlog de todas las prioridades, asignadas y sin asignar, con descripciones variadas.

Asumiendo que estás en la raíz del monorepo (syncro/):

cd apps/web
npx prisma migrate deploy   # crea el esquema
npx prisma db seed          # carga los datos demo

📖 Guía completa paso a paso → Seeder y guía de datos demo

Documentación

Onboarding — Stack, Clean Architecture y principios del proyecto
- El proyecto — Visión del equipo, objetivos y cómo contribuir
Backend — Decisiones técnicas (Prisma, Auth, tiempo real, deployment)
Frontend — Routing, i18n, componentes, dark mode y layout del workspace
SOLID — Los 5 principios explicados con ejemplos
Git Flow — Estrategia de ramas y flujo de trabajo
Changelog — Registro de cambios recientes del proyecto
Contribuir — Guía para añadir documentación