waynesutton/Codex-Sites-Convex-Backend-Skill

¿Qué hace Codex-Sites-Convex-Backend-Skill?

Construye y despliega un sitio de Codex utilizando Convex como base de datos en tiempo real y backend, con una sola habilidad reutilizable de Codex.

¿Qué hace?

Esta habilidad permite a un agente de IA (Codex) crear y desplegar un sitio web completo donde:

• Codex Sites proporciona el frontend y el alojamiento estático.
• Convex actúa como backend serverless con base de datos en tiempo real, autenticación, y funciones backend (queries, mutations, acciones).

Requisitos previos

• Una cuenta en Codex (o el servicio de Anthropic).
• Una cuenta en Convex.
• Node.js 18+ y npm.
• Convex CLI instalado globalmente (npm install -g convex).

Cómo usarla

1. Codex iniciará un nuevo proyecto de Codex Site.
2. Configurará Convex como backend, ejecutando npx convex dev.
3. Definirá esquemas de datos (tablas, índices) en convex/schema.ts.
4. Implementará funciones backend (queries, mutations, acciones) en convex/.
5. Conectará el frontend con el backend usando el hook useQuery o useMutation.
6. Desplegará el sitio completo con npx convex deploy.

Estructura del proyecto

mi-proyecto/
├── convex/          # Backend de Convex
│   ├── schema.ts    # Esquema de la base de datos
│   ├── tasks.ts     # Queries y mutations
│   └── auth.ts      # Configuración de autenticación
├── src/             # Frontend de Codex Site
│   ├── App.tsx      # Componente principal
│   └── index.tsx    # Punto de entrada
├── package.json
└── convex.json      # Configuración de Convex

Funcionalidades clave

• Autenticación: Soporta inicio de sesión con proveedores populares (Google, GitHub, etc.) mediante Convex Auth.
• Tiempo real: Las queries se actualizan automáticamente cuando cambian los datos.
• Despliegue automatizado: Un solo comando despliega tanto frontend como backend.
• Iteración rápida: Codex puede modificar esquemas y funciones sobre la marcha.

Limitaciones

• Requiere conexión a internet para el backend de Convex.
• El plan gratuito de Convex tiene límites de uso (lecturas, escrituras, almacenamiento).

Soporte

Para preguntas o problemas, consulta la documentación oficial de Codex Sites y Convex.