तुम्हारे पास ideas हैं। महीनों से हैं। किसी notes app में पड़े-पड़े guilt में बदल रहे हैं। हर Monday सोचते हो "अगले weekend" और हर Sunday रात तुमने desk organize कर लिया होता है — ship कुछ नहीं होता।
परेशानी talent या tools की नहीं है। Process की है। ज़्यादातर weekend projects इसलिए मरते हैं क्योंकि builders Saturday को वो decisions ले रहे होते हैं जो Friday को ले लेने चाहिए थे, और Sunday को वो चीज़ें polish कर रहे होते हैं जो किसी ने माँगी ही नहीं। 🔍
छह महीने पहले ये guide practical नहीं होती। Claude Code एक spec file से full-stack app reliably scaffold नहीं कर पाता था। Supabase के free tier में edge functions नहीं थे। Vercel के hobby plan की deployment limits tight थीं। लेकिन March 2026 के अंत तक, इस playbook का हर tool इतने generous free tier पर चलता है कि तुम एक real product ship कर सकते हो — कोई toy demo नहीं। Weekend MVP की cost "कुछ हज़ार hosting और APIs में" से गिरकर "literally ₹0 अगर ध्यान से करो" हो गई है। यही window है। 💰
ये वो playbook है जो मैंने पिछले साल सैकड़ों weekend launches देखकर reverse-engineer किया है — जिन्होंने actually Sunday रात तक एक live URL produce किया, real users के साथ। Prototype नहीं। Figma mockup नहीं। एक deployed product। Secret weapon: Claude Code — Anthropic का terminal-based AI coding assistant जो तुम्हारा project पढ़ता है, code लिखता है, और commands चलाता है — सीधे तुम्हारे codebase के अंदर।
Friday रात: एक घंटा decisions का (code का नहीं)
Weekend Friday रात 9 बजे शुरू होता है। Code से नहीं — decisions से। Saturday को जितने minutes deliberation में खर्च करोगे, उतने minutes building में नहीं लगेंगे।
Project shape चुनो
ये वो shapes हैं जो realistically weekend में ship हो सकती हैं:
| Shape | Example | Complexity |
|---|---|---|
| Tool | PDF merger, image compressor, text formatter | Low |
| Dashboard | Analytics viewer, status page, metrics display | Medium |
| Marketplace lite | Directory, listing site, curated collection | Medium |
| SaaS micro | Auth और billing page वाला single-feature product | Medium-High |
| API wrapper | कोई ugly API लो और उसे सुंदर बना दो | Low-Medium |
One-page spec लिखो
File खोलो। बस इतना लिखो। इससे ज़्यादा कुछ नहीं:
# Weekend MVP: [Name]
## One sentence
[क्या करता है, किसके लिए]
## Core flow
1. User page पर आता है
2. User [main action] करता है
3. User को [result] मिलता है
## Must have (Saturday)
- [ ] Landing page
- [ ] Core feature
- [ ] Production URL पर deploy
## Nice to have (Sunday)
- [ ] Auth
- [ ] Email notifications
- [ ] Basic analytics
## Will NOT build
- [ ] Admin panel
- [ ] Payment processing
- [ ] Mobile app
- [ ] User profiles
वो "Will NOT build" section? पूरे doc का सबसे important हिस्सा। ये scope creep के खिलाफ़ तुम्हारी ढाल है — वो natural tendency जिसमें "बस एक और चीज़" add करते-करते Sunday ख़त्म हो जाता है और कुछ complete नहीं बनता।
Repo set up करो
Repo (repository) बस एक project folder है जिसे Git track करता है — version control software जो तुम्हारी हर change save करता है, जैसे तुम्हारे code के लिए infinite undo।
mkdir my-mvp && cd my-mvp
git init
# EK stack चुनो। Debate मत करो।
# Option A: Next.js + Supabase (full-stack, सबसे flexible)
npx create-next-app@latest . --typescript --tailwind --app
# Option B: Static + API (simpler, faster)
# बस index.html बनाओ और एक /api folder
touch SPEC.md # अपना one-page spec यहाँ paste करो
git add -A && git commit -m "init: weekend mvp"
Next.js एक React-based framework है — इसे web apps बनाने का starter kit समझो जो routing, server-side rendering, और deployment सब handle करता है। Supabase तुम्हें database, user login, और file storage देता है — zero server setup के साथ।
Saturday सुबह: Core बनाओ (4-5 घंटे)
उठो। चाय पकड़ो। Terminal खोलो। Social media नहीं, email नहीं, "बस एक चीज़ check कर लूँ" नहीं।
घंटे 1-2: Claude Code से scaffold करो
यहाँ Claude Code अपना असली रंग दिखाता है। अपनी project directory में खोलो:
claude
Full context दो:
Read SPEC.md. This is a weekend MVP — we're building
the minimum possible product.
Scaffold the project:
1. Set up the page structure based on the core flow
2. Create the main feature component
3. Set up basic styling with Tailwind
4. Create a layout with nav and footer
5. No auth yet, no database yet — just the UI and core logic
Claude Code 5-15 files generate करता है। हर line review मत करो। तीन चीज़ें check करो: चलता है (npm run dev), core flow है, code structure ठीक है?
घंटे 2-4: Core feature implement करो
बस यही code matter करता है। बाकी सब scaffolding है — structural support जो product नहीं है।
मान लो तुम meeting cost calculator बना रहे हो। Claude Code को बोलो:
The core feature is a calculator that takes:
- Number of participants
- Average hourly rate
- Meeting duration
And shows a real-time cost counter, total cost, and
cost-per-minute breakdown. Single React component.
No backend needed. Use useState for the timer,
useEffect for the counter animation.
Claude Code लिख देता है। Browser में test करो। Iterate करो:
The counter animation is jerky. Use requestAnimationFrame
instead of setInterval. Make the cost number huge — 72px,
monospace font.
Key discipline: सिर्फ़ core feature पर iterate करो। Nav गलत लग रहा है? लिख लो। Cosmetics Sunday को ठीक करना।
घंटे 4-5: Deploy 🚀
Lunch से पहले deploy करो। एक live URL होना — एक real address जो कोई भी visit कर सके — तुम्हारी psychology "code से खेल रहा हूँ" से "product बना रहा हूँ" में बदल देता है।
# Vercel (Next.js के लिए सबसे fast)
npx vercel
# या Cloudflare Pages (static sites के लिए सबसे fast)
npx wrangler pages deploy ./out
Vercel हर code push पर auto-deploy करता है। Free tier किसी भी MVP के लिए काफ़ी है। URL किसी एक इंसान को भेजो। उनका 30-second reaction तुम्हें एक हफ़्ते की solo development से ज़्यादा बताएगा।
Lunch: उठो और चले जाओ
Seriously। खाना खाओ जो desk पर ना हो। Afternoon session दोगुना productive होगा जब दिमाग़ को rest मिलेगा।
Saturday दोपहर: Connective tissue (3-4 घंटे)
Core feature काम कर रहा है। अब इसे product जैसा feel कराओ।
घंटे 6-7: Database (अगर ज़रूरत है)
हर MVP को database नहीं चाहिए — data store और retrieve करने की structured जगह। Calculator को नहीं चाहिए। Directory को चाहिए।
अगर तुम्हें चाहिए, Claude Code को बोलो:
Set up Supabase:
1. Design the minimum schema — only tables for the core flow
2. Set up the client in lib/supabase.ts
3. Add basic CRUD for the main data type
4. No RLS yet, no complex queries — just make it work
CRUD मतलब Create, Read, Update, Delete — किसी भी data पर चार basic operations। RLS (Row Level Security) control करता है कि कौन कौन सी rows देख सकता है। अभी skip करो।
Supabase का free tier 500 MB PostgreSQL देता है — एक powerful open-source database। MVP के लिए तुम लगभग 1 MB use करोगे। यानी 500 MVPs का headroom। 💰
// lib/supabase.ts — बस इतना ही चाहिए
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(
process.env.NEXT_PUBLIC_SUPABASE_URL!,
process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
)
घंटे 7-8: Auth (अगर ज़रूरत है)
Auth (authentication) — users को login करवाना ताकि identify हो सकें। Meeting calculator को नहीं चाहिए। Personal dashboard को चाहिए।
Add Supabase Auth:
1. Email + password signup/login
2. Simple auth form component
3. Protected route for the dashboard
4. Session management via middleware
5. No social login, no MFA — just email and password
MFA (multi-factor authentication) वो दूसरा code होता है जो phone से आता है। Supabase Auth 50,000 monthly active users free handle करता है। MVP weekend में तुम कभी उस limit को नहीं छुओगे।
घंटे 8-9: Landing page
तुम्हारे landing page को exactly चार चीज़ें चाहिए:
- Headline — क्या करता है (5-8 words)
- Subheadline — किसके लिए है (1 sentence)
- CTA button — "Try it free" / "Get started"
- One screenshot — product काम करते हुए दिखाओ
Create a landing page:
- Hero section with headline, subheadline, and CTA
- One section showing the core feature
- Simple footer with contact info
- No testimonials, no pricing, mobile responsive
Feature comparison table नहीं। "Trusted by" logos नहीं। Animated gradients नहीं। Real चीज़ ship करो, real चीज़ के बारे में marketing site नहीं।
Sunday: Polish और launch (6-8 घंटे)
सुबह: Saturday में ignore की हर चीज़ ठीक करो ⚡
Saturday के notes खोलो। Claude Code को batch में दो:
Fix these in order:
1. Nav doesn't highlight the active page
2. Mobile menu doesn't close after clicking a link
3. Loading state shows blank — add a skeleton
4. Form validation missing on email field
5. Footer links go nowhere — add pages or remove links
हर fix छोटा है। मिलकर ये "demo" को "product" बना देते हैं।
दोपहर: Launch checklist
### Works
- [ ] Core feature desktop Chrome पर काम करता है
- [ ] Core feature mobile Safari पर काम करता है
- [ ] सारे links कहीं जाते हैं
- [ ] Forms input validate करते हैं
- [ ] Errors user-friendly messages दिखाते हैं
### Looks right
- [ ] Favicon है
- [ ] Page title और meta description set है
- [ ] Social sharing के लिए OG image है
- [ ] कोई placeholder text नहीं ("Lorem ipsum")
- [ ] Consistent spacing और typography
### Production ready
- [ ] Environment variables production में set हैं
- [ ] HTTPS काम करता है
- [ ] Loading time 3 seconds से कम
- [ ] कोई console errors नहीं
- [ ] 404 page है
Claude Code से बोलो: "Run through this checklist against our codebase. Tell me what passes, what fails, fix the failures." Minutes में handle कर लेता है।
शाम: Ship करो
Twitter/X, relevant Discord servers, एक Reddit thread, Hacker News "Show HN" पर post करो अगर fit करता है। ये post format काम करता है:
मैंने [product name] इस weekend बनाया — ये [audience] के लिए [thing] करता है। [URL] Next.js + Supabase + Claude Code से बनाया। Feedback welcome.
2000 शब्दों का launch essay मत लिखो weekend project के लिए। Product बोलता है या नहीं बोलता।
वो time-killers जो weekend MVPs तबाह कर देते हैं 🗑️
| Time killer | Tempting क्यों लगता है | Trap क्यों है |
|---|---|---|
| Custom design system | "Professional लगना चाहिए" | Tailwind defaults अच्छे दिखते हैं |
| Auth from scratch | "Third-party पर trust नहीं" | Supabase Auth में 10 minute लगते हैं |
| Database optimization | "Scale हुआ तो?" | तुम्हारे 0 users हैं। 1,000 पर optimize करना |
| CI/CD pipeline | "Best practices" | main पर push करो। Vercel auto-deploy करता है |
| Test suite | "Tests होने चाहिए" | Weekend MVP को manual test करो |
| Payment integration | "Monetize करना है" | पहले users लाओ। Week 2 में Stripe add करो |
| Admin panel | "Data manage करना है" | Supabase dashboard directly use करो |
CI/CD (Continuous Integration/Continuous Deployment) मतलब हर code push पर automated testing और deploying। सही time पर valuable है। ये weekend वो time नहीं है।
Realistic timeline
Friday 9pm: Spec लिखो, repo set up करो (1h)
Saturday 9am: Scaffold + core feature (4h)
Saturday 1pm: Lunch break (1h)
Saturday 2pm: Database + auth + landing page (4h)
Saturday 8pm: आज के लिए बस
Sunday 10am: Polish + bug fixes (3h)
Sunday 2pm: Launch checklist + deploy (2h)
Sunday 5pm: Online post करो + feedback लो (1h)
Sunday 6pm: Weekend MVP shipped
Total focused coding time: ~14h
14 घंटे focused काम। 48 घंटे बिना नींद के scrambling नहीं। दोनों रातें सोओ। Sunday सुबह exercise करो। आराम किया हुआ code थके हुए code को हर बार हराता है।
🦝 Schnapps की राय
Weekend MVP तुम्हारे idea का stress-test है, तुम्हारी stamina का नहीं। अगर तुम एक sentence में नहीं बता सकते कि product क्या करता है, तो weekend में बना भी नहीं सकते। अगर Claude Code की help से भी core feature 4 घंटे में नहीं बन सकता, तो feature MVP के लिए बहुत complex है।
जो projects ship होते हैं उनमें एक trait common है: builder ने scope बेरहमी से काटा। Landing page पर एक section। App में एक feature। Database में दो tables। और ship हो गया।
जो projects ship नहीं होते उनमें भी एक trait common है: builder ने Saturday दोपहर ये research करने में बिताया कि page transitions के लिए कौन सी animation library use करें। MVP में page transitions नहीं होते। एक page होता है, और वो काम करता है। वही ship करो। 🚀
