Registrarse

Inicio rápido

Pon en marcha tu aplicación en minutos con esta guía de inicio rápido.

Nota: Este es contenido de ejemplo/marcador de posición con fines de demostración.

Configura y pon en marcha tu entorno de desarrollo rápidamente.

Requisitos previos

Antes de empezar, asegúrate de tener:

  • Node.js 18.x o superior
  • pnpm 8.x o superior
  • Git para el control de versiones
  • Una cuenta de Supabase (el plan gratuito funciona perfectamente)

Paso 1: Clonar el repositorio

git clone https://github.com/yourorg/yourapp.git
cd yourapp

Paso 2: Instalar las dependencias

pnpm install

Esto instalará todas las dependencias necesarias en todo el monorepo.

Paso 3: Configurar las variables de entorno

Copia el archivo de entorno de ejemplo:

cp apps/web/.env.example apps/web/.env.local

Actualiza las siguientes variables:

# Configuración de Supabase
NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here

# Aplicación
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Paso 4: Iniciar Supabase

Inicia tu instancia local de Supabase:

pnpm supabase:web:start

Esto hará lo siguiente:

  • Iniciar la base de datos PostgreSQL
  • Iniciar Supabase Studio (localhost:54323)
  • Aplicar todas las migraciones
  • Cargar los datos iniciales

Paso 5: Iniciar el servidor de desarrollo

pnpm dev

Tu aplicación estará disponible en:

  • Aplicación: http://localhost:3000
  • Supabase Studio: http://localhost:54323
  • Pruebas de correo electrónico: http://localhost:54324

Paso 6: Crear tu primer usuario

  1. Ve a http://localhost:3000/auth/sign-up
  2. Introduce tu correo electrónico y tu contraseña
  3. Revisa http://localhost:54324 para ver el correo de confirmación
  4. Haz clic en el enlace de confirmación
  5. ¡Ya está todo listo!

Próximos pasos

Ahora que tu aplicación está en funcionamiento:

  1. Explora el panel - Descubre las funcionalidades principales
  2. Revisa el código - Familiarízate con la estructura
  3. Lee la documentación - Conoce los conceptos clave
  4. Crea tu funcionalidad - Empieza a personalizar

Problemas comunes

El puerto ya está en uso

Si el puerto 3000 ya está en uso:

# Busca y finaliza el proceso
lsof -i :3000
kill -9 <PID>

Supabase no se inicia

Prueba a restablecer Supabase:

pnpm supabase:web:stop
docker system prune -a  # Limpia Docker
pnpm supabase:web:start

Error de conexión a la base de datos

Asegúrate de que Docker se esté ejecutando y reinicia Supabase:

docker ps  # Comprueba que Docker se está ejecutando
pnpm supabase:web:reset

¿Qué sigue?