Nun Ibiza — PinBoard App

App móvil interna para empleados de Nun Ibiza. Centraliza noticias, eventos, chat y comunicación del equipo en un entorno corporativo seguro.

Stack

Tecnología	Rol
Expo + React Native	Framework y toolchain principal
TypeScript	Tipado estático en todo el proyecto
Expo Router v3	Navegación basada en archivos
NativeWind	Estilos Tailwind CSS via prop className
Supabase	Auth, Postgres, Realtime, Storage, Edge Functions
EAS Build	Builds para distribución

Requisitos previos

• Node.js LTS
• pnpm (npm install -g pnpm)
• Supabase CLI (npx supabase --version)
• Para Android: Android Studio con emulador configurado
• Para iOS: macOS con Xcode

Instalación

# Instalar dependencias
pnpm install

Variables de entorno

Crea un archivo .env en la raíz con:

EXPO_PUBLIC_SUPABASE_URL=https://<project>.supabase.co
EXPO_PUBLIC_SUPABASE_ANON_KEY=<anon-key>

Scripts disponibles

Comando	Descripción
pnpm dev	Servidor Metro (Expo Go / dev client)
pnpm dev:ios	Abre directamente en simulador iOS
pnpm dev:android	Abre directamente en emulador Android
pnpm lint	ESLint — cero warnings permitidos
pnpm format	Prettier — formatea todo el proyecto
pnpm typecheck	TypeScript — comprueba tipos sin emitir
pnpm test	Jest — ejecuta la suite de tests
pnpm build:ios	EAS Build para iOS
pnpm build:android	EAS Build para Android

Ejecución

# Servidor de desarrollo
npx expo start

# Android
npx expo run:android

# iOS
npx expo run:ios

Supabase local

# Arrancar entorno local (Docker)
pnpm run supabase:start

# Aplicar migraciones
npx supabase db push

# Generar tipos TypeScript desde el esquema
npx supabase gen types typescript --local > lib/database.types.ts

Estructura del proyecto

├── app/                     # Rutas de Expo Router
│   ├── (auth)/              # login, set-password, reset-password
│   └── (app)/               # guard: sin sesión → /(auth)/login
│       ├── (tabs)/          # tablon, calendario, chat, perfil
│       ├── modals/          # nuevo-post, nuevo-evento, nuevo-chat
│       └── admin/           # gestión de usuarios (solo admin)
├── components/              # Componentes UI reutilizables
│   └── ui/                  # Text, View, Button, Card con tokens de diseño
├── hooks/                   # Custom hooks
├── lib/                     # Cliente Supabase tipado, utilidades
├── assets/                  # Imágenes, fuentes, iconos
└── supabase/
    ├── migrations/          # SQL versionado
    └── functions/           # Edge Functions (Deno runtime)

Documentación

La documentación completa del proyecto (arquitectura, diseño, decisiones técnicas) está en Notion.

Arquitectura — ADRs

Las decisiones técnicas significativas se documentan como ADRs en docs/adr/:

ADR	Título	Estado
ADR-001	Modelo de engagement: viewed / engaged / clicked	Aceptado
ADR-002	Control de acceso basado en roles (RBAC) + RLS	Aceptado
ADR-003	Push notifications y deep-linking	Aceptado
ADR-004	Arquitectura del chat en tiempo real: persistente / efímero	Aceptado
ADR-005	Almacenamiento de imágenes: buckets, paths, límites y pipeline cliente	Aceptado

CI / Pipeline local

El pipeline de CI se ejecuta automáticamente en cada PR y push a main. Para reproducirlo en local:

pnpm install --frozen-lockfile && pnpm lint && pnpm typecheck && pnpm test

Convenciones

• Todo el código en TypeScript (.ts / .tsx). Sin archivos .js / .jsx.
• Estilos con NativeWind (clases Tailwind en la prop className). Evitar StyleSheet.create salvo casos que NativeWind no cubra.
• Autorización siempre en Supabase RLS (Postgres), nunca en el cliente.
• Paquetes con pnpm add. CLI de Expo con npx expo .... CLI de Supabase con npx supabase ....