Visit the website at the link: https://heavenly-shadows.web.app/
π About the project
Heavenly Shadows is a literary website dedicated to the poetry collection Sombras de um Vislumbre Celeste (Shadows of a Celestial Glimpse), by Leo L. Oliveira. The platform offers a unique visual, interactive experience to explore the authorβs different poetic styles and personae.
π οΈ Tech stack
Frontend
- Next.js 15 β React framework for web applications
- React 19 β JavaScript library for user interfaces
- TailwindCSS 4 β Utility-first CSS framework
- Framer Motion β Animation library
- ShadCN β Modern UI components
- React Query β State management and caching
- React Hook Form β Form handling
- Zod β Schema validation
Backend
- Firebase Firestore β NoSQL database
- Firebase Admin SDK β SDK for authentication and management
- MailerSend β Email delivery service
Infrastructure
- Vercel β Hosting and continuous deployment (CD)
π¨ Project structure
heavenly-shadows/ βββ app/ # App pages and routes β βββ api/ # API routes β βββ actions/ # Server Actions β βββ components/# Reusable components β βββ hooks/ # Custom hooks β βββ lib/ # Utilities and config β βββ services/ # External services β βββ types/ # Type definitions β βββ styles/ # Global styles
π Getting started
Prerequisites
- Node.js (version 16 or higher)
- npm or yarn
Installation
- Clone the repository:
git clone [REPOSITORY_URL] cd heavenly-shadows
- Install dependencies:
npm install
- Set up environment variables:
# .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
- Start the development server:
npm run dev
π License
This project is licensed under the MIT License.








