Heavenly Shadows

Accede al sitio web mediante el enlace: https://heavenly-shadows.web.app/

📚 Acerca del proyecto

Sombras celestes es un sitio web literario dedicado a la recopilación de poesía Sombras de um Vislumbre Celeste (Sombras de un atisbo celeste), de Leo L. Oliveira. La plataforma ofrece una experiencia visual e interactiva única para explorar los distintos estilos y personas poéticas del autor.

🛠️ Stack tecnológico

Frontend

• Next.js 15 — Framework React para aplicaciones web
• React 19 — Biblioteca JavaScript para interfaces de usuario
• TailwindCSS 4 — Framework CSS de utilidades (utility-first)
• Framer Motion — Biblioteca de animación
• ShadCN — Componentes de UI modernos
• React Query — Gestión de estado y caché
• React Hook Form — Manejo de formularios
• Zod — Validación de esquemas (schema)

Backend

• Firebase Firestore — Base de datos NoSQL
• Firebase Admin SDK — SDK para autenticación y administración
• MailerSend — Servicio de envío de correo

Infraestructura

• Vercel — Plataforma de alojamiento y deploy continuo (CI/CD)

🎨 Estructura del proyecto

heavenly-shadows/
├── app/            # Páginas y rutas de la app
│   ├── api/        # Rutas de la API
│   ├── actions/   # Server Actions
│   ├── components/# Componentes reutilizables
│   ├── hooks/     # Hooks personalizados
│   ├── lib/       # Utilidades y configuración
│   ├── services/  # Servicios externos
│   ├── types/     # Definiciones de tipos
│   └── styles/    # Estilos globales

🚀 Cómo empezar

Requisitos previos

• Node.js (versión 16 o superior)
• npm o yarn

Instalación

1. Clona el repositorio:

git clone [REPOSITORY_URL]
cd heavenly-shadows

1. Instala las dependencias:

npm install

1. Configura las variables de entorno:

# .env.local
FIREBASE_PRIVATE_KEY=your-private-key
FIREBASE_PROJECT_ID=your-project-id
FIREBASE_CLIENT_EMAIL=your-client-email
MAILER_SEND_KEY=your-mailer-send-key

1. Inicia el servidor de desarrollo:

npm run dev

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT.