Tribu

La forma chilena de saber dónde están los tuyos y encontrar a los tuyos.

App móvil de ubicación social para Chile. Construida con Flutter + Firebase.

Estructura del repositorio

.
├── CLAUDE.md                  ← LEER PRIMERO. Contexto del proyecto y reglas.
├── docs/                      ← Documentación viva del producto y arquitectura.
│   ├── 01-mvp-scope.md
│   ├── 02-data-model.md
│   ├── 03-privacy-architecture.md
│   └── sprints/               ← Plan de trabajo por sprint.
├── lib/                       ← Código Flutter.
├── functions/                 ← Cloud Functions (TypeScript).
├── firestore.rules
├── storage.rules
└── firebase.json

Para trabajar con Claude Code

1. Abrir CLAUDE.md y leerlo completo.
2. Identificar el sprint actual en docs/sprints/.
3. Tomar una tarea T0X-XX y pedir a Claude Code que la implemente referenciando su ID.
4. Después de cada tarea: flutter analyze, flutter test, commit, push, PR.

Setup local (primera vez)

# 1. Flutter (3.24+)
flutter --version

# 2. Firebase CLI
npm install -g firebase-tools
firebase login

# 3. FlutterFire CLI
dart pub global activate flutterfire_cli

# 4. Dependencias
flutter pub get
cd functions && npm install && cd ..

# 5. Configurar flavors (pide credenciales al lead)
./scripts/setup-flavors.sh

# 6. Correr
flutter run --flavor dev

Stack

• Flutter 3.24+ con Riverpod + go_router
• Firebase (Auth, Firestore, Functions, Storage, FCM, Remote Config, Crashlytics)
• Mapbox para mapas
• RevenueCat para suscripciones
• PostHog para analytics de producto

Ver CLAUDE.md sección 3 para detalles.

Roadmap

Fase	Semanas	Hito
Setup	1-2	Proyecto andando + CI/CD
Auth + onboarding	3-4	Registro + perfil básico
Mapa privado + amigos	5-6	Núcleo Zenly-like
Grupos + chat	7-8	Carretes, rutas, geofencing
Beta cerrada	9	50-100 usuarios reales
Capa pública	10	Perfiles + mapa público
Premium	11	Suscripciones + Punto Preciso
Lanzamiento Viña+Valpo	12	App Store + Play Store

Contribuir

• Una rama por feature: feat/sprint-XX-task-YY-short-desc
• Conventional Commits (feat:, fix:, chore:, etc.)
• PR requiere CI verde + 1 review
• Nada se mergea a main sin pasar por develop y staging

Licencia

Propietaria. Todos los derechos reservados.