Documentación para Desarrolladores

Guía para desarrolladores y colaboradores de JoxAI.

Introducción

Bienvenido a la documentación técnica de JoxAI. Esta guía está destinada a desarrolladores y colaboradores que deseen entender, instalar y ejecutar el proyecto del sitio web corporativo de JoxAI. Nuestro objetivo es mantener un código limpio, escalable y bien documentado.

Stack Tecnológico

Nuestra plataforma utiliza un stack moderno y robusto para garantizar la mejor experiencia de usuario y de desarrollo.

Frontend

  • Framework: Next.js 14 (App Router)
  • Lenguaje: TypeScript
  • Estilos: Tailwind CSS
  • Componentes UI: shadcn/ui
  • Animaciones: Framer Motion

Backend & Base de Datos

  • BaaS: Supabase

Instalación Rápida

Para poner en marcha el proyecto en su entorno local, siga estos pasos:

1. Clone el repositorio desde GitHub:

git clone <URL_DEL_REPOSITORIO>
cd joxai-website

2. Instale todas las dependencias del proyecto:

npm install

3. Configure las variables de entorno (ver sección más abajo).

4. Inicie el servidor de desarrollo:

npm run dev

Scripts Disponibles

Estos son los scripts principales que puede ejecutar con npm:

  • npm run dev: Inicia el servidor de desarrollo.
  • npm run build: Compila la aplicación para producción.
  • npm run start: Inicia un servidor de producción.
  • npm run lint: Ejecuta ESLint para analizar el código.

Variables de Entorno

Cree un archivo llamado .env.local en la raíz del proyecto y añada sus claves de Supabase:

NEXT_PUBLIC_SUPABASE_URL=tu_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=tu_supabase_anon_key

Estructura del Proyecto

La estructura de carpetas está organizada para ser intuitiva y escalable:

/
├── app/              # Páginas y layouts (App Router)
├── components/       # Componentes reutilizables
├── lib/              # Utilidades (ej. Supabase client)
├── public/           # Archivos estáticos
└── ...

Soporte

Si encuentra algún problema técnico, contacte a nuestro equipo de soporte en: support@joxai.org.