Tiki

MVP armado para Shippear 3.0 (Rosario, 24 de octubre de 2026). Publicás un plan, lo compartís por WhatsApp o con un QR y se suma gente que no conocés pero tiene ganas de lo mismo. Cuando llegás al plan y te encontrás con otra persona del grupo, ganás puntos para canjear por descuentos en negocios asociados.

Qué hace

• Armar un plan (con cuenta). Quien organiza crea una cuenta con usuario y contraseña, sin mails ni confirmaciones. Carga qué es, dónde (con sugerencias de direcciones y mapa de Google), día, horario, cupo fijo o sin límite y una descripción opcional. Nombre y teléfono se piden la primera vez y quedan en la cuenta.
• Sumarse sin cuenta. Desde el link o el QR, con nombre y teléfono. Si el navegador ya se anotó antes, se suma en un toque.
• Compartir por WhatsApp. El plan arma el mensaje con el link listo para mandar; también se puede copiar el link o usar el menú de compartir del celular.
• Encuentros. Desde 2 horas antes del plan, quien se sumó ve el botón Llegué. Ahí tiene su QR, que cambia cada 30 segundos, y un botón para escanear el de otra persona del plan. Alcanza con que escanee uno de los dos para que la llegada quede confirmada para ambos. El primer encuentro da 50 puntos a cada uno y cada persona nueva que conocés después suma 10, hasta 5. Las dos pantallas muestran la misma pregunta para arrancar la charla. Quien organiza participa como cualquier otra persona. Si alguien escanea el QR con la cámara del teléfono en lugar de hacerlo desde Tiki, se abre una página para confirmar el encuentro.
• Puntos. Se ganan en los encuentros; sumarse a un plan no da puntos. En Puntos están el saldo, los movimientos y los beneficios. El canje descuenta los puntos y genera un código de 6 letras que vence a los 30 minutos; la pantalla del código tiene un reloj en vivo, porque en una captura vieja la hora queda congelada.
• Pantalla para proyector. En /e/<código>/pantalla: QR grande y contador de gente anotada que se actualiza solo cada 3 segundos. Cuando empiezan los encuentros, muestra también cuántas personas llegaron y cuántos encuentros hubo.
• Tiki en Claude (MCP). En https://planes-mvp.vercel.app/api/mcp, sin cuenta: buscar planes, ver uno y sumarse con nombre y celular. Para crear un plan, Claude devuelve un link a /crear con el formulario completo, y ahí Tiki pide iniciar sesión. La portada tiene un botón Conectar con Claude que abre el formulario de conector de claude.ai con todo cargado. El diseño está en docs/mcp.md.

Todos ven todos los planes. La identidad visual sigue el template Next.js boilerplate de v0: fondo casi negro, rojo como color principal, Montserrat en los títulos e Inter en el texto.

Correr en local

Hace falta Node 20 o más nuevo y Docker.

npm install
cp .env.example .env.local
docker compose up -d
npm run db:reset
npm run dev

La app queda en http://localhost:3000.

Para probar el QR con el celular, abrí la app desde la compu con su IP de la red wifi (por ejemplo http://192.168.0.15:3000): el QR y los links usan la misma dirección con la que se abrió la página, así que un celular en la misma wifi los puede abrir. El navegador solo deja usar la cámara con HTTPS o en localhost, así que con la IP de la red el escáner de Llegué no abre: para probar un encuentro así, escaneá el QR con la cámara del teléfono, o usá la versión publicada.

npm run db:reset borra todo y vuelve a cargar los negocios de ejemplo de supabase/seed.sql. Para aplicar migraciones nuevas sin borrar datos: npm run db:migrate.

Con npm run dev andando, npm run test:mcp prueba el MCP con el cliente MCP oficial contra la base local. Para usarlo desde Claude Code: claude mcp add --transport http tiki-local http://localhost:3000/api/mcp.

This is the beginning of the README. Read the rest at the original. Read the full README ↗