🚀 iBuiltThis

iBuiltThis is a community-driven platform where creators, builders, and innovators showcase their latest projects and discover what’s launching next. From AI tools to SaaS products, it’s the home for authentic launches and genuine feedback.

---

✨ Features

🛠️ The Tech Stack

Built with the cutting-edge Next.js 16 and React 19 ecosystem for maximum performance and a type-safe developer experience:

• Framework: Next.js 16 (App Router) using Dynamic IO for intelligent request handling.
• Auth: Clerk (Passkeys, GitHub, Google) for secure, frictionless onboarding.
• Database: NeonDB serverless PostgreSQL for scalable, edge-ready storage.
• ORM: Drizzle ORM for full type-safety from the schema to the UI.
• Styling: Tailwind CSS 4 + Shadcn UI for a high-performance, accessible interface.
• Validation: Zod for strict schema enforcement on the client and server.

💫 Application Highlights

• Optimized Discovery: Tag-based categorization, "Featured" showcases, and "Recently Launched" feeds.
• Creator Workflow: Streamlined submission process with Zod-validated forms and instant feedback.
• Real-time Engagement: Community voting system (Upvote/Downvote) featuring Optimistic UI updates for zero-latency interactions.
• Admin Governance: Integrated moderation panel to review, approve, or manage product submissions.
• Hybrid Caching: Leverages Next.js 16 "use cache" to serve static content instantly while streaming dynamic user data via React Suspense.

---

🚦 Getting Started

Prerequisites

• A Clerk account for Authentication.
• A Neon.tech project for your PostgreSQL database.
• Node.js 20+ installed.

1. Installation

• Clone the repository, then

cd iBuiltThis
npm install

2. Environment Setup

• Create a .env.local file in the root directory and add your credentials from Clerk and Neon:

CLERK_SECRET_KEY=""
DATABASE_URL=""

3. Database Initialization

• Sync your schema and push migrations to Neon using Drizzle:

npx drizzle-kit push

4. Run Development Server

• Start the local server and visit http://localhost:3000:

  npm run dev

🏗️ Architecture & Structure

├── app/              # Next.js App Router (Explore, Submit, Auth)
├── components/       # UI Library (Shadcn + Product Specific Components)
├── db/               # Drizzle Schema & Neon Database Configuration
├── lib/              # Core Logic
│   ├── products/     # Server Actions (Voting, Submitting) & Data Selects
│   └── utils.ts      # UI Class Merging Helpers
├── types/            # Global TypeScript Definitions
└── public/           # Static Brand Assets