FreeTheHomie 🗣️✨

AI-Powered Fundraising Platform
Live Demo • Features • Tech Stack • Getting Started • Configuration

---

FreeTheHomie is a next-generation fundraising platform with merchandising storefronts to fund community causes. Built with Next.js 15, React 19, and Radix + shadcn/ui, it delivers a fast, accessible, mobile-first experience with automated deployment via Vercel.

---

---

✨ Features

• 👕 Fundraising Storefront: Sell merch or collectibles to support campaigns
• 🔄 Auto-Sync: GitHub + Vercel integration keeps production up-to-date
• 📱 Mobile-First UI: Built with Radix primitives, shadcn/ui, Tailwind 4
• 🎨 Theming: Dark/light mode, brand-consistent design
• 📊 Engagement Analytics: Track visits, chat interactions, conversions
• 🔧 Configurable: Easy environment setup for campaigns, chat flows, and branding
• ⚡ Edge-Ready: Deployed on Vercel Edge for fast global performance

---

🛠️ Tech Stack

• Framework: Next.js 15 (App Router) + React 19
• UI & Styling: Tailwind CSS 4, Radix UI, shadcn/ui, Lucide React Icons
• Animations & UX: Framer Motion, Vaul (drawer/overlay), React Resizable Panels
• Forms & Validation: React Hook Form, Zod
• State & Theme: React Context, next-themes
• Charts: Recharts for engagement insights
• Build & Deploy: Vercel CI/CD, GitHub Actions (optional)
• Other Tools: Sonner (toasts), date-fns (formatting), cmdk (command palette)

---

🚀 Getting Started

Prerequisites

• Node.js 18+
• pnpm or npm (project ships with pnpm lockfile)
• Vercel account linked to your GitHub repo
• v0.app project for AI chat integration

Quick Start

git clone https://github.com/DigitalHerencia/FreeTheHomie.git
cd FreeTheHomie
pnpm install
pnpm dev

Visit http://localhost:3000 to see the storefront running locally.

Production Deployment

Copy code
pnpm build
pnpm start   # or deploy via Vercel CLI
vercel --prod

🔧 Configuration

Create a .env.local file with the following:

V0_PROJECT_ID=jb9UThzEonh
NEXT_PUBLIC_SITE_URL=https://your-vercel-deployment.vercel.app

Optional analytics / custom config

You can override colors, fonts, and layout via tailwind.config.ts and components.json.

📖 How It Works

1. Design chat flows in v0.app visual builder
2. Push changes → repo auto-syncs → Vercel deploys latest build
3. Users interact with your AI-powered chat + storefront
4. Engagement data can be visualized with built-in analytics components

🤝 Contributing

Contributions welcome!

• Branch Naming: feature/, fix/
• Commit Style: Conventional commits (feat:, fix:, docs:)
• Testing: Manual and automated tests before PR submission

📝 License

MIT License – see LICENSE for details.

FreeTheHomie – Fund the Movement. Deploy the Future. 🗣️✨