Skip to content

princepal9120/vibestack

Repository files navigation

🚀 VibeStack

The Community Platform for AI-Assisted Coding

GitHub Stars GitHub Forks GitHub Issues License Next.js TypeScript

View Demo · Report Bug · Request Feature


VibeStack Preview

🌟 What is VibeStack?

VibeStack is a community-driven platform that bridges the gap between learning AI-assisted coding and showcasing real-world projects. It serves as a centralized hub where developers can:

  • 📚 Learn – Access industry-grade setup guides, workflows, and best practices for AI coding tools like Cursor, Claude Code, and more
  • 🔨 Build – Contribute and showcase projects built with vibe coding platforms
  • 💡 Inspire – Discover, collaborate, and get inspired by others' work

Why VibeStack?

AI coding tools are everywhere, but knowledge is fragmented. Developers waste time:

  • Searching for scattered documentation
  • Guessing best practices
  • Working in isolation with no real-world examples

VibeStack solves this by providing a unified platform with curated guides, community projects, and shared learnings.


✨ Features

🎯 Core Features

Feature Description
Platform Profiles Comprehensive guides for Cursor, Claude Code, Gemini CLI, and more
Project Showcase Upload and discover community projects with screenshots, tech stack, and insights
Resource Library Curated blogs, tutorials, YouTube videos, and X/Twitter threads
MCP Directory Browse Model Context Protocol servers and integrations
Sub-Agents Library Role-specific AI agent prompts (React Architect, Python Expert, etc.)
Skills Repository Modular AI capabilities like Anthropic's Skills
Curated Collections Themed project collections (e.g., "Best Cursor Projects")

🚀 Platform Features

  • 🔐 Authentication – Secure sign-in with Clerk (GitHub, Google, Email)
  • 🔍 Global Search – Fuzzy search with Cmd+K across all content
  • ⬆️ Upvoting System – Community-driven project rankings
  • 💬 Comments – Engage with project authors
  • 🏷️ Filtering – Filter by platform, tech stack, category
  • 📱 Responsive Design – Beautiful on all devices
  • 🌙 Dark Mode – Easy on the eyes

🛠️ Tech Stack

Technology Purpose
Next.js 16 React framework with App Router
TypeScript Type-safe development
Tailwind CSS 4 Utility-first styling
Prisma Type-safe ORM
PostgreSQL Database (via Neon)
Clerk Authentication & user management
Framer Motion Animations
Fuse.js Fuzzy search
Zod Schema validation
Vercel Deployment & hosting

📁 Project Structure

vibestack/
├── src/
│   ├── app/                      # Next.js App Router
│   │   ├── (main)/               # Main routes (resources, projects, platforms, etc.)
│   │   ├── api/                  # API routes
│   │   │   ├── projects/         # Project CRUD endpoints
│   │   │   ├── resources/        # Resource endpoints
│   │   │   ├── search/           # Search API
│   │   │   └── webhooks/         # Clerk webhooks
│   │   ├── sign-in/              # Auth pages
│   │   ├── sign-up/
│   │   ├── layout.tsx            # Root layout
│   │   ├── page.tsx              # Landing page
│   │   └── globals.css           # Global styles
│   │
│   ├── components/               # React components
│   │   ├── ui/                   # Base UI components (shadcn/ui)
│   │   ├── navbar.tsx            # Navigation
│   │   ├── footer.tsx            # Footer
│   │   ├── command-palette.tsx   # Cmd+K search
│   │   ├── project-card.tsx      # Project display
│   │   ├── resource-bento-card.tsx
│   │   └── ...
│   │
│   ├── lib/                      # Utilities & config
│   │   ├── prisma.ts             # Database client
│   │   ├── auth.ts               # Auth helpers
│   │   ├── validators.ts         # Zod schemas
│   │   └── utils.ts              # Utility functions
│   │
│   └── proxy.ts                  # API proxy configuration
│
├── prisma/
│   ├── schema.prisma             # Database schema
│   └── seed.ts                   # Seed data
│
├── content/                      # Markdown content (guides, resources)
├── public/                       # Static assets
└── package.json

🚀 Getting Started

Prerequisites

  • Node.js 18+ (Download)
  • npm, yarn, pnpm, or bun
  • PostgreSQL database (we recommend Neon)

Installation

  1. Clone the repository

    git clone https://github.com/princepal9120/vibestack.git
    cd vibestack
  2. Install dependencies

    npm install
    # or
    pnpm install
    # or
    bun install
  3. Set up environment variables

    cp .env.example .env
  4. Configure your .env file (see Environment Variables)

  5. Set up the database

    # Generate Prisma client
    npx prisma generate
    
    # Run migrations
    npx prisma migrate dev
    
    # (Optional) Seed the database
    npm run db:seed
  6. Start the development server

    npm run dev
  7. Open your browser

    Visit http://localhost:3000 🎉


🔐 Environment Variables

Create a .env file in the project root with the following variables:

# ======================
# Database (PostgreSQL with Neon)
# ======================
DATABASE_URL="postgresql://user:password@host-pooler.neon.tech/vibestack?sslmode=require"
DIRECT_URL="postgresql://user:password@host.neon.tech/vibestack?sslmode=require"

# ======================
# Clerk Authentication
# ======================
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="pk_test_..."
CLERK_SECRET_KEY="sk_test_..."
CLERK_WEBHOOK_SECRET="whsec_..."

# Clerk URLs (optional)
NEXT_PUBLIC_CLERK_SIGN_IN_URL="/sign-in"
NEXT_PUBLIC_CLERK_SIGN_UP_URL="/sign-up"
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL="/"
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL="/"

# ======================
# Cloudinary (Image Uploads)
# ======================
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME="your-cloud-name"
CLOUDINARY_API_KEY="your-api-key"
CLOUDINARY_API_SECRET="your-api-secret"

# ======================
# App Configuration
# ======================
NEXT_PUBLIC_APP_URL="http://localhost:3000"
📖 Where to get these values
Variable Where to get it
DATABASE_URL / DIRECT_URL Neon Dashboard → Create Project → Connection Details
CLERK_* keys Clerk Dashboard → Create App → API Keys
CLOUDINARY_* Cloudinary Dashboard → Settings → Access Keys

📖 Usage Examples

Browsing Platform Guides

1. Navigate to /platforms
2. Select a platform (e.g., "Cursor")
3. Explore setup guides, workflows, and cheat sheets

Uploading a Project

1. Sign in with GitHub/Google
2. Click "Showcase Your Project"
3. Fill in project details, tech stack, and screenshots
4. Write key insights about how you used AI tools
5. Publish and share with the community!

Using the Command Palette

1. Press Cmd+K (Mac) or Ctrl+K (Windows)
2. Type to search across all content
3. Select a result to navigate instantly

🤝 Contributing

We ❤️ contributions! VibeStack is built by the community, for the community.

Quick Start

# 1. Fork the repository
# 2. Clone your fork
git clone https://github.com/YOUR_USERNAME/vibestack.git

# 3. Create a feature branch
git checkout -b feature/amazing-feature

# 4. Make your changes and commit
git commit -m "feat: add amazing feature"

# 5. Push and open a PR
git push origin feature/amazing-feature

Contribution Guidelines

Code Standards

  • TypeScript – Strong typing, avoid any
  • Conventional Commitsfeat:, fix:, docs:, etc.
  • Component Structure – Functional components with hooks
  • Styling – Tailwind CSS, mobile-first responsive

🗺️ Roadmap

✅ v1.0 (Current)

  • Platform profiles & guides
  • Project showcase & gallery
  • Resource library with filtering
  • User authentication
  • Comments & upvoting
  • Global search (Cmd+K)

🚧 v1.1 (In Progress)

  • Email notifications
  • Enhanced user profiles
  • Admin content dashboard
  • Advanced filtering options

🔮 v2.0 (Future)

  • Advanced search (Meilisearch)
  • User-created collections
  • Leaderboards & badges
  • Project of the week
  • Follow users
  • Nested comment replies
  • API for third-party integrations
Have ideas for the roadmap?

We'd love to hear from you! Open a discussion or submit a feature request.


📜 License

This project is open source and available under the MIT License.

MIT License

Copyright (c) 2026 VibeStack

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...

🙏 Acknowledgements


🌟 Show Your Support

If VibeStack has helped you, please consider:

  • Starring the repository
  • 🐦 Sharing on social media
  • 💬 Telling your friends and colleagues
  • 🤝 Contributing to the project

Built with ❤️ by the VibeStack community

GitHub · Issues · Discussions

About

Your hub for AI coding tools & community.Discover platform guides, projects, sub-agents, skills, and resources for Cursor, Claude Code, Gemini CLI, and more. 100% open source.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors