Asama México — Docs

Documentación interna del monorepo. Contiene tres aplicaciones activas y un worker serverless.

Estructura del monorepo


monorep-asamamx/
├── apps/
│   ├── studio/     # Sanity Studio — panel de administración de contenido
│   ├── web/        # Sitio web principal (Next.js, static export)
│   ├── worker/     # API serverless (Cloudflare Workers + Hono)
│   └── docs/       # Este sitio de documentación (Nextra + MDX)
├── packages/       # Paquetes compartidos (vacío, estructura lista)
├── turbo.json      # Configuración de tareas de Turborepo
└── pnpm-workspace.yaml

Stack

Herramienta	Versión	Rol
Node.js	24	Runtime local
PNPM	11	Gestor de paquetes
Turborepo	2	Orquestación del monorepo
Next.js	16	Web y Docs
Sanity	5	CMS headless
Nextra	4	Documentación MDX
Tailwind CSS	4	Estilos (web)
TypeScript	5	Tipado estático
React	19	UI
Hono	4	Router HTTP del worker
Supabase	2	Base de datos (PostgreSQL)
Cloudflare Workers	—	Runtime del worker

Primeros pasos

Requisitos

Node.js 24+
PNPM 11+

Instalación


pnpm install

Desarrollo


# Todo en paralelo (studio, web, docs — no incluye worker)
pnpm turbo dev
 
# Por app
pnpm --filter @asamamx/studio dev   # :3333
pnpm --filter @asamamx/web dev      # :3000
pnpm --filter @asamamx/worker dev   # :8787
pnpm --filter @asamamx/docs dev     # :3001

Para desarrollo completo (reservaciones + pagos), correr web y worker simultáneamente.

Variables de entorno

`apps/web/.env.local`


NEXT_PUBLIC_WORKER_URL=
NEXT_PUBLIC_PAYPAL_CLIENT_ID=
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=
NEXT_PUBLIC_SANITY_PROJECT_ID=
NEXT_PUBLIC_SANITY_DATASET=

`apps/worker/.dev.vars`


JWT_SECRET=
SUPABASE_URL=
SUPABASE_SECRET_KEY=
PAYPAL_CLIENT_ID=
PAYPAL_CLIENT_SECRET=
RESEND_API_KEY=

Scripts disponibles

Comando	Descripción
`turbo dev`	Servidores de desarrollo en paralelo
`turbo build`	Build de todas las apps
`turbo check-types`	Verificación de tipos TypeScript
`turbo lint`	Linting de todas las apps
`--filter @asamamx/studio build`	Build del Studio (output estático para autoalojamiento)
`--filter @asamamx/worker deploy`	Publica Worker en Cloudflare