A junkyard for vibecode with potential
Vibeyard is a community-driven platform where developers can showcase, discover, and collaborate on AI-assisted code projects (vibecode). Think of it as a junkyard where raw materials meet potential—a place to find diamonds in the rough, connect with collaborators, and transform experimental AI-generated code into production-ready applications.
In the rapidly evolving landscape of AI-assisted development, countless promising projects are created daily using tools like Claude, GPT, and other AI coding assistants. However, many of these projects remain isolated, incomplete, or abandoned. Vibeyard solves this problem by providing a centralized platform where:
- Creators can showcase their AI-generated projects and seek help, feedback, or collaborators
- Contributors can discover interesting projects that need expertise, mentorship, or development resources
- Teams can form around promising ideas and transform rough prototypes into polished applications
The platform embraces the "junkyard" theme—celebrating the raw, experimental nature of AI-assisted development while recognizing that every piece of scrap has potential value in the right hands.
Ready to run vibeyard locally? Check out our Quick Start Guide for step-by-step instructions.
Prerequisites:
- Node.js 20+
- Docker & Docker Compose
- GitHub account (for OAuth)
Quick Setup:
# Install dependencies
npm install
# Start Docker services (PostgreSQL + Redis)
docker-compose up -d
# Set up environment variables
cp .env.example .env
# Add your GitHub OAuth credentials
# Run database migrations
npx prisma migrate dev
# Start development server
npm run dev
Visit http://localhost:3000 to see your local vibeyard!
For detailed instructions, see docs/SETUP.md.
- Seamless Authentication: Sign in with your GitHub account
- Repository Connection: Link your vibecode repositories with one click
- Automatic Analysis: Upon connection, Vibeyard analyzes your repository to extract:
- Project description and purpose
- AI provider and model used for development (Claude, GPT, etc.)
- Agent configurations and workflows
- Development progress and milestones
- Commit history and evolution
- Common mistakes and lessons learned
- Project Discovery: Browse all connected repositories displayed as "lots" on the landing page
- Detailed Lot Pages: Click any lot to view comprehensive project information:
- Project description and current status
- AI-assisted development analysis
- Technology stack and dependencies
- Links back to GitHub repository
- Development journey and progress indicators
- Community Engagement:
- Upvote promising projects
- Follow projects to track their evolution
- Comment and provide feedback
- Connect with project creators
Your personal workspace for managing your vibecode projects:
- View all your connected repositories
- Monitor project analytics and engagement
- Manage collaboration requests
- Track improvement suggestions from the community
- Seekers: Developers looking for help, code reviews, bug fixes, or team members
Collaboration Options:
- Request human code reviews
- Seek help fixing specific issues
- Form development teams around promising projects
- Offer expertise to projects that align with your skills
- Follow repositories for any updates
- Automatic license detection for each connected repository
- Prompt users to add appropriate licenses if missing
- Ensure all projects meet open-source compliance standards
- Platform concept and architecture design
- GitHub OAuth integration
- Repository connection
- Repository Analysis engine backend
- Show Completeness Rating on the frontend: Assign a quality score (1-5 stars) based on:
- Code completeness and functionality
- Documentation quality
- Test coverage
- Deployment readiness
- Yard Lot (public listing) interface
- Workbench (user dashboard) interface
- Basic upvoting functionality
- Basic repository/lot following/subscribe functionality with user notifications (in app only for now)
- RSS feed for new repositories added to Yard Lot
- Add WTF menu item and page to the top nav with FAQ like content explaining vibeyard platform
- Add "vibecode" menu item and informational page to the top nav explaining vibecoding and how to do it correctly:
- For example with Claude Code:
- Use of Agents with examples
- Use of Skills with examples
- Use of MCP servers with examples
- Skills that combine skills, agents, MCPs to create Feature development Workflows eg. feature-dev skill
- Context Window management
- Direct Agents/Skills to save implementation decisions/tasks to file for future course correction
- Commenting system with notifications (in app only for now)
- Nested indentation - Replies are visually indented to show parent-child relationships, creating a tree structure
- Minimalist/text-first design - No avatars, no rich media, monospace-adjacent typography on a muted background
- Flat metadata header - Username, relative timestamp, and navigation links (parent | root | prev | next) inline
- Collapse controls - The [-] toggle to collapse entire sub-threads
- Upvote-only voting - Single triangle, no downvote visible to most users
- Simple "reply" action - Unobtrusive link at comment bottom
- Package the main and analysis worker as Dockerfiles for deployment with Helm to K8s
- Add these Docker services to the local docker compose for development and testing
- Create Github template repo with only the local Claude featureset and add link to vibecode page. This will help users getting started with vibecoding
- Automated Build & Deploy: Attempt to build and deploy connected projects
- Live Previews: Screenshots and live demos of successfully deployed applications
- Log Monitoring: Display build logs, deployment logs, and runtime insights
- Lot Hosting: Optional paid hosting for projects on generated
.vibeyard.aiURLs - Custom Domains: Support for custom domain mapping
- Project Marketplace: Allow creators to list projects for sale or licensing
- Premium Features: Advanced analytics, priority support, enhanced collaboration tools
- AI-assisted project improvement suggestions
- Automated refactoring recommendations
- Integration with CI/CD pipelines
- Project forking and derivative tracking
- Grant/funding connection platform for promising projects
Vibeyard embraces a simple, functional design inspired by classic developer communities like Hacker News:
- Minimalist interface prioritizing content over chrome
- Fast, responsive, and accessible
- Focus on information density and usability
- The "junkyard" naming convention permeates the platform:
- Yard Lot: Public marketplace of projects
- Workbench: Private development dashboard
- Scrap Tags: Project categorization
- Salvage Score: Quality/completeness rating
- Forge: Collaboration and team-building area
- Transparency in AI-assisted development processes
- Recognition that experimental code has inherent value
- Celebrating both successful projects and instructive failures
- Building connections between creators and collaborators
Current Stack:
- Frontend: Next.js 14 with App Router, React 18, TypeScript
- Styling: Tailwind CSS
- Database: PostgreSQL 15 with Prisma ORM
- Caching: Redis with BullMQ job queue
- Authentication: NextAuth.js v5 with GitHub OAuth
- Repository Analysis: GitHub API (Octokit) + OpenAI GPT-4
- Deployment: Kubernetes + Helm + GitHub Actions
- Testing: Vitest (unit) + Playwright (E2E)
- Quick Start Guide - Get up and running quickly
- Setup Instructions - Detailed local development setup
- Deployment Guide - K8s deployment with Helm
- Task Breakdown - All 64 development tasks
- Phase 1 Summary - Implementation overview
- Setup Checklist - Verification checklist
- Implementation Summary - Complete technical details
External Documentation:
Vibeyard itself is a vibecode project! We welcome contributions from the community:
- Feedback: Share your thoughts on features and functionality
- Code Contributions: Submit PRs for bug fixes or new features
- Documentation: Help improve our docs and guides
- Community: Join discussions about AI-assisted development
(Contribution guidelines to be added)
(License to be determined)
Our vision is to create a thriving ecosystem where AI-assisted development is celebrated, collaborative, and productive. By providing infrastructure for discovery, collaboration, and deployment, Vibeyard aims to:
- Reduce abandonment of promising AI-generated projects
- Accelerate the journey from prototype to production
- Foster a community that learns from both successes and failures
- Make AI-assisted development more accessible and collaborative
- Demonstrate that "vibecode" can evolve into robust, valuable software
(Contact information to be added)
Built with AI assistance | Powered by community collaboration | Celebrating the potential in every line of code