Vibe Coding Challenge with Spec2Code

📦 Spec2Code Package

npm: https://www.npmjs.com/package/spec2code

🎯 Challenge Overview

Welcome to the Vibe Coding Challenge using the Specification-Driven Development (Spec2Code) tool! This challenge demonstrates how AI can build complete, production-ready applications following rigorous software engineering principles.

🛠️ What is Spec2Code?

Spec2Code (Specification-Driven Development) is a revolutionary development methodology that enforces:

• Test-Driven Development (TDD) with strict ordering: Contract → Integration → E2E → Unit → Implementation
• Constitutional Gates that prevent over-engineering and ensure quality
• Library-First Architecture with thin UI veneers
• Progressive Enhancement for web applications
• Full Traceability from requirements to code
• Integration-First Testing with real dependencies

📋 Challenge Structure

Challenge 1: Recipe Finder (Built in 3 hours)

Prompt: "Build a recipe finder app where users input ingredients and get matching recipes, using HTML, CSS, and vanilla JavaScript"

Challenge 2: Invoce Generator (Built in 5.5 hours)

Prompt: "Build an invoice generator that lets users enter client details and items and download as PDF, using React, CSS, and jsPDF"

Challenge 3: Appointment Scheduler (Built in 3.5 hours)

Prompt: "Build a personal finance dasboard to track spending categories and visualize with charts using React, Typescript, Tailwind, Chartjs"

Challenge 4: Personal Finance Dashboard (Built in 3 hours)

Prompt: "Create an appointment scheduler with a calendar view and booking slots, using React, Tailwind CSS, and date-handling library like date-fns"

Challenge 5: Mental Health Journal (Built in 3.5 hours)

Prompt: "Create a mental health journal app where users log mood daily and view trend charts, using Next.js, TypeScript, Tailwind"

Challenge 6: Personal Shopping Assistant (Built in 4.5 hours)

Prompt: "Prompt: Create a virtual personal shopping assistant that suggests products based on user preferences, using React, TypeScript, Node.js backend, PostgreSQL, and a simple recommendation algorithm"

Challenge 7: Market Place (Built in 4.5 hours)

Prompt: "Prompt: Create a marketplace app where users list items and allow browsing/purchase, using Next.js, TypeScript, Tailwind, Node.js backend, Stripe, and PostgreSQL or MongoDB"

Challenge 8: Event Organizer (Built in 5.5 hours)

Prompt: "Prompt: Build a virtual event organizer app managing attendees, schedule, notifications, and networking, using Next.js, TypeScript, Tailwind, Supabase (Auth, real-time DB, storage), WebSockets for real-time features"

Challenge 9: Collaborative Whiteboard (Built in 6 hours)

Prompt: "Prompt: Build a collaborative whiteboard app where multiple users can draw and add sticky notes in real time, using Next.js, TypeScript, Tailwind, Supabase Realtime and deploy on Vercel"

Challenge 10: Kanban (Built in 5.5 hours)

Prompt: "Build a kanban project management app with drag-and-drop tasks, user authentication, and team workspaces, using Next.js, TypeScript, Tailwind, Supabase"

Challenge 11: Video Conference (Built in 6.5 hours)

Prompt: "Build a video conferencing web app with room creation, screen sharing, and chat, using Next.js, TypeScript, Tailwind, socket.io"

Challenge 12: Learning Management System (Built in 5 hours)

Prompt: "Create a multi-tenant LMS (learning management system) where different organizations host courses, quizzes, student progress, and admin dashboards, using Next.js, TypeScript, Tailwind, Prisma, PostgreSQL, NextAuth"

Challenge 13: AR Decorator (Built in 8 hours)

Prompt: "Develop a web-based AR home decorator where users upload room photos and virtually place furniture/décor items and preview in augmented reality, using React, three.js or WebGL, backend image processing APIs."

Challenge 14: Resume Reviewer (Built in 3 hours)

Prompt: "Prompt: Create an AI-powered résumé reviewer app where users upload resumes and receive AI feedback, using Next.js, TypeScript, Tailwind, Google Gemini API, file upload via Vercel Blob, and deploy on Vercel."

Challenge 15: Crowdfunding Platform (Built in 3.5 hours)

Prompt: "Prompt: Develop a crowdfunding / campaign platform where users can create campaigns, manage donations, comment, and track goals, using Next.js, TypeScript, Tailwind."

Challenge 16: Legal Assistant (Built in 3 hours)

Prompt: "Build a Turkish-localized AI legal assistant web app where users upload contract templates (e.g., Gizlilik, Hizmet, Danışmanlık, Mesafeli Satış, Aydınlatma Metni) and ask questions in Turkish about risks, obligations, or KVKK compliance. The system analyzes clauses, generates tailored agreements, and explains legal context using retrieved sources. Use Next.js, TypeScript, and Tailwind for UI with PostgreSQL for storage; integrate Gemini API for text generation and retrieval-augmented answering."

Challenge 17: FoodLens (Built in 2.5 hours)

Prompt: "Build a cross-platform React Native (Expo) app that scans food labels via camera and—using Vercel AI Gateway returns a beautiful, human-readable nutrition and allergen info card (EN/TR) with healthier alternatives, powered by a Firebase backend for secure model calls, auth, and image storage."

Challenge 18: Uncle Taxim (Built in 7 hours)

Prompt: "Build an iOS ride-hailing app (like Uber) using SwiftUI and Firebase backend, featuring AI voice-based booking, dynamic ride suggestions ranked by ETA + cost + preferences, smart chat support for cancellations and ETAs, and contextual trip summaries (cost, route, CO₂ footprint, best travel time), all routed securely through the Vercel AI Gateway for model calls."

🎯 Learning Objectives

This challenge demonstrates:

1. Specification-Driven Development: How to build from requirements
2. Test-Driven Development: Writing tests before implementation
3. Progressive Enhancement: Building for all users and devices
4. API-First Design: Building robust, testable APIs
5. Quality Engineering: Constitutional gates and best practices
6. Full-Stack Development: Complete application architecture

🤝 Contributing

This is a learning challenge! Feel free to:

• Study the code and architecture
• Run the tests and see how they work
• Experiment with the API
• Try adding new features following SDD principles
• Share your learnings and improvements

📄 License

MIT License - feel free to use this code for learning and experimentation.

---

Happy Coding! 🚀

Built with ❤️ using Spec2Code methodology