HeartCrafted 💌

Crafting Emotions Into Forever.

A luxury emotional gifting platform that transforms memories, love stories, friendships, and life's most meaningful moments into handcrafted keepsakes.

Live site: heartcrafted-guls.vercel.app

Demo

✨ Features

• AI Gift Matcher — a guided 4-question quiz (recipient, occasion, what matters most, style) that recommends the perfect handcrafted gift
• Bespoke Gift Builder — a "Tell Us Your Story" flow where customers share memories, photos, and emotions for artisans to craft into a custom keepsake
• Curated Collections — browse handcrafted gifts like the Forever Memory Box, Love Story Scrapbook, Friendship Legacy Kit, and Voice Memory Frame
• Stories & Testimonials — real customer stories showcasing the emotional impact of each gift
• Memory Gallery — a visual showcase of past handcrafted keepsakes
• Contact & Newsletter — direct inquiry form plus an email subscription for gift inspiration and early access

📸 Screenshots

Homepage — Crafting Emotions Into Forever	Curated gift collections
AI Gift Matcher — guided quiz	Perfect match result
Bespoke Gift Builder — tell your story	Stories that made us cry (happily)
Memory Gallery — crafted with love	About — born from a gift that changed everything
Let's craft something special

🛠️ Tech Stack

• Framework: Next.js 15 (App Router) + React 19
• Language: TypeScript
• Styling: Tailwind CSS 4
• Database / ORM: Prisma 7
• Animation: GSAP (with @gsap/react), Framer Motion, Lenis smooth scroll
• Media: Cloudinary via next-cloudinary
• Forms & validation: React Hook Form + Zod
• Email: Resend
• Icons: Lucide
• Linting: ESLint 9

🚀 Getting Started

Prerequisites

• Node.js 18.18+ (or 20+ recommended)
• A package manager: npm, yarn, pnpm, or bun
• A PostgreSQL (or your configured) database for Prisma
• Cloudinary and Resend API credentials (for media uploads and email)

Installation

git clone https://github.com/GulsumBegam/HeartCrafted-guls.git
cd HeartCrafted-guls
npm install

Environment Variables

Create a .env file in the project root with the variables your setup needs, for example:

DATABASE_URL="postgresql://user:password@host:5432/heartcrafted"

NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret

RESEND_API_KEY=your_resend_api_key

Check prisma/schema.prisma and the codebase for the exact variable names your instance expects.

Database Setup

npx prisma generate
npx prisma migrate dev

Run the Development Server

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 in your browser to see the result.

📜 Available Scripts

Script	Description
npm run dev	Start the development server
npm run build	Build the app for production
npm run start	Start the production server
npm run lint	Run ESLint

📁 Project Structure

HeartCrafted-guls/
├── prisma/       # Prisma schema & migrations
├── public/       # Static assets
├── src/          # Application source (pages/components/lib, etc.)
├── next.config.ts
├── tsconfig.json
└── package.json

☁️ Deployment

The easiest way to deploy this app is via Vercel, the platform from the creators of Next.js. See the Next.js deployment docs for details.

🤝 Contributing

Contributions, issues, and feature requests are welcome. Feel free to open a pull request or file an issue.

📬 Contact

Have a vision for a gift, a story to share, or a question? Reach out via the contact page on the live site.

📄 License

No license has been specified yet for this repository. Consider adding one (e.g. MIT) if you intend for others to use or contribute to this project.