🕶️ Shadow Founder

Your AI Co-Founder That Doesn't Sugarcoat

Validate startup ideas with ruthless AI honesty → Get scored → Build your MVP in seconds

🚀 Most founders waste months building something nobody wants. Shadow Founder tells you the truth in 30 seconds — then builds your MVP if it's worth it.

🤔 What is Shadow Founder?

Shadow Founder is an AI-powered startup validation & MVP generation platform built for the Indian startup ecosystem. It acts as your brutally honest co-founder that:

🔍 Validates your startup idea using AI (scores it 0-100)
💬 Coaches you with follow-up AI chat for strategy refinement
⚡ Builds a complete MVP codebase with a stunning landing page
📦 Exports everything as a downloadable ZIP — ready to deploy

No fluff. No "great idea!" fakery. Just raw, data-backed analysis and actionable output.

✨ Features

🎯 AI Startup Validator

Submit your idea with target audience, problem, revenue model & competitors
Get a 0-100 viability score with verdict: VIABLE · CONDITIONAL PASS · RISKY · NOT VIABLE
Deep analysis: TAM, competition level, revenue potential, feasibility, India market fit, MVP time, scalability, user acquisition
Strengths, weaknesses, recommendations, failure risks, founder checklist
Competitor analysis with big players breakdown (strengths & weaknesses)
Monetization strategies tailored to your idea
Illegal/harmful ideas get auto-rejected with a score of 0 🚫

💬 AI Strategy Chat

Follow-up conversation with Shadow Founder AI after validation
Ask about pivots, GTM strategy, fundraising, tech stack decisions
Full conversation history persisted to your account
Streaming responses for real-time feel

⚡ MVP Code Generator

One-click MVP generation from any validated idea
Generates complete codebase: package.json, pages, layouts, components, config
Stunning landing page (preview.html) with 12 sections:
- Nav (Glassmorphism) · Hero (Glass + Bauhaus shapes) · Logo Cloud (Bauhaus) · Problem Old vs New (Neumorphism) · Features (Glassmorphism cards) · How It Works (Bauhaus geometric) · Stats (Neumorphism dark) · Showcase (Glass mockup) · Testimonials (Neobrutalism) · Pricing (Glass + Neu mix) · FAQ (Bauhaus accent) · CTA (Glass over dark)
10 unique color themes per category (SaaS, Fintech, Health, EdTech, E-commerce, Social, AI/ML, Gaming, Food, Travel)
All prices in ₹ (INR) with Indian names & cities
Live preview in sandboxed iframe
🎉 Confetti celebration when your MVP is ready!

📁 Assembly (Code Viewer)

Interactive file tree explorer
Syntax-highlighted code viewer
Copy individual files to clipboard
Download entire project as ZIP
Toggle between Code and Preview modes
Edit popup for customization tips

👤 Profile & Plans

Free Plan: 1 MVP build
Pro Plan: 10 MVP builds
Enterprise Plan: Unlimited builds
Build usage tracking
Coming soon: Dark Mode, API Keys, GitHub/Slack integrations, Team Access

🏗️ Tech Stack

Layer	Technology	Why
🖥️ Framework	Next.js 16 (App Router)	Server components, API routes, streaming
⚛️ UI	React 19	Latest concurrent features
🎨 Styling	Tailwind CSS 4	Utility-first, rapid prototyping
🎭 Animations	Framer Motion	Smooth page transitions & micro-interactions
🤖 AI	Groq SDK (LLaMA 3.3 70B + GPT-OSS 120B)	Ultra-fast inference for validation & code gen
🗄️ Database	MongoDB Atlas + Mongoose	Flexible schema for analyses & builds
🔐 Auth	Clerk	Social login, session management, middleware
📦 Export	JSZip	Client-side ZIP generation
🎉 Confetti	canvas-confetti	Celebration effects
🎨 Icons	Lucide React	Beautiful consistent icons
📊 Analytics	Vercel Analytics	Production monitoring

📂 Project Structure

shadow-founder/
├── app/
│   ├── page.tsx                    # 🏠 Landing page
│   ├── layout.tsx                  # Root layout (Clerk provider, fonts)
│   ├── globals.css                 # Global styles
│   ├── loading.tsx                 # Root loading spinner
│   │
│   ├── (auth)/                     # 🔐 Auth pages
│   │   ├── sign-in/[[...sign-in]]/ # Sign in
│   │   └── sign-up/[[...sign-up]]/ # Sign up
│   │
│   ├── (dashboard)/                # 📊 Protected dashboard
│   │   ├── layout.tsx              # Dashboard shell (sidebar, nav)
│   │   ├── dashboard/page.tsx      # Hub — all analyses
│   │   ├── validator/page.tsx      # 🎯 Submit ideas for validation
│   │   ├── builder/page.tsx        # ⚡ Build MVP from analyses
│   │   ├── analysis/[id]/page.tsx  # 📋 Deep analysis + AI chat
│   │   ├── assembly/[id]/page.tsx  # 📁 Code viewer + preview
│   │   └── profile/page.tsx        # 👤 User profile & plans
│   │
│   ├── api/
│   │   ├── validate/route.ts       # 🤖 AI validation endpoint
│   │   ├── generate/route.ts       # ⚡ MVP code generation
│   │   ├── analyses/route.ts       # 📋 List all analyses
│   │   ├── analyses/[id]/route.ts  # 📋 Single analysis CRUD
│   │   ├── analyses/[id]/chat/     # 💬 AI chat streaming
│   │   ├── builds/[id]/route.ts    # 📦 Fetch build data
│   │   └── user/route.ts           # 👤 User profile & plan
│   │
│   └── sso-callback/page.tsx       # OAuth callback handler
│
├── lib/
│   ├── mongodb.ts                  # Database connection
│   └── models/
│       ├── Analysis.ts             # Analysis schema
│       ├── Build.ts                # Build schema
│       └── User.ts                 # User schema
│
├── public/                         # Static assets
├── proxy.ts                        # Clerk middleware
├── next.config.ts                  # Next.js config
├── tailwind.config.ts              # Tailwind config
└── package.json                    # Dependencies

🚀 Getting Started

Prerequisites

Node.js 20+
MongoDB Atlas account (free tier works)
Clerk account (free tier works)
Groq API key (free tier works)

1. Clone the repo

git clone https://github.com/StarDust130/Shadow-Founder.git
cd Shadow-Founder

2. Install dependencies

npm install

3. Set up environment variables

Create a .env.local file in the root:

# 🗄️ MongoDB
MONGO_DB_URL=mongodb+srv://<user>:<password>@<cluster>.mongodb.net/shadow-founder?retryWrites=true&w=majority

# 🤖 Groq AI
QROQ_API_KEY=gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 🔐 Clerk Auth
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_xxxxxxxxxxxxxxxx
CLERK_SECRET_KEY=sk_xxxxxxxxxxxxxxxx

4. Run the dev server

npm run dev

Open http://localhost:3000 and start validating ideas! 🎯

🔌 API Reference

Validate an Idea

POST /api/validate

{
  "idea": "AI-powered grocery delivery for tier-2 Indian cities",
  "target": "Busy professionals in smaller cities",
  "problem": "No reliable quick delivery in tier-2 cities",
  "category": "E-commerce",
  "revenue": "Commission + delivery fees",
  "competitors": "Swiggy Instamart, Zepto"
}

Response: Analysis object with score (0-100), verdict, metrics, strengths, weaknesses, recommendations, failure risks, monetization strategies.

Generate MVP

POST /api/generate

{
  "analysisId": "60f7b3b3b3b3b3b3b3b3b3b3"
}

Response: Build object with complete file tree (package.json, pages, components, preview.html).

AI Chat

POST /api/analyses/:id/chat

{
  "messages": [
    { "role": "user", "content": "How should I approach fundraising for this?" }
  ]
}

Response: Server-sent event stream with AI strategy advice.

🎨 Design System

Shadow Founder uses a Neobrutalism design language across the dashboard:

Token	Value	Usage
`Primary`	`#FF6803`	Buttons, accents, highlights
`Dark`	`#1A1A1A`	Borders, text, dark backgrounds
`Background`	`#FFFBF5`	Page backgrounds (warm cream)
`Border`	`2px solid #1A1A1A`	All cards, inputs, buttons
`Shadow`	`4px 4px 0 #1A1A1A`	Card offset shadows
`Hover Shadow`	`6px 6px 0 #FF6803`	Interactive hover state
`Radius`	`14-20px`	Card corners
`Font Weight`	`700-900`	Bold, impactful typography

Generated MVP previews mix Glassmorphism + Bauhaus + Neumorphism + Neobrutalism for unique, fresh designs every time.

🤖 AI Models

Model	Provider	Used For	Temperature
`llama-3.3-70b-versatile`	Groq	Startup validation & analysis	0.7
`openai/gpt-oss-120b`	Groq	MVP code generation	0.7
`openai/gpt-oss-120b`	Groq	App name generation	0.9
`llama-3.3-70b-versatile`	Groq	Follow-up AI chat	0.7

🇮🇳 Built for India

All pricing in ₹ (INR) — no dollar conversions
Indian competitor analysis (Flipkart, Razorpay, Zerodha, BYJU'S, etc.)
Indian testimonial names & cities (Mumbai, Bangalore, Delhi, Pune, Chennai)
UPI & Indian banking references
Tier-1, Tier-2, Tier-3 city market insights
Indian data protection compliance mentions

📸 How It Works

┌──────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│              │     │              │     │              │     │              │
│  📝 Submit   │────▶│  🤖 AI       │────▶│  📊 Get      │────▶│  ⚡ Build    │
│  Your Idea   │     │  Validates   │     │  Score &     │     │  Your MVP    │
│              │     │  Ruthlessly  │     │  Analysis    │     │  Code        │
│              │     │              │     │              │     │              │
└──────────────┘     └──────────────┘     └──────────────┘     └──────────────┘
                                                │
                                                ▼
                                         ┌──────────────┐
                                         │              │
                                         │  💬 Chat     │
                                         │  with AI     │
                                         │  for advice  │
                                         │              │
                                         └──────────────┘

🛠️ Scripts

Command	Description
`npm run dev`	Start development server
`npm run build`	Production build
`npm run start`	Start production server
`npm run lint`	Run ESLint

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

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

⭐ Star this repo if Shadow Founder helped you validate your idea!

Built with 🧡 by StarDust130

🌐 Live Demo · 🐛 Report Bug · 💡 Request Feature

Name		Name	Last commit message	Last commit date
Latest commit History 151 Commits
app		app
lib		lib
public		public
.gitignore		.gitignore
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
proxy.ts		proxy.ts
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

🕶️ Shadow Founder

Your AI Co-Founder That Doesn't Sugarcoat

🤔 What is Shadow Founder?

✨ Features

🎯 AI Startup Validator

💬 AI Strategy Chat

⚡ MVP Code Generator

📁 Assembly (Code Viewer)

👤 Profile & Plans

🏗️ Tech Stack

📂 Project Structure

🚀 Getting Started

Prerequisites

1. Clone the repo

2. Install dependencies

3. Set up environment variables

4. Run the dev server

🔌 API Reference

Validate an Idea

Generate MVP

AI Chat

🎨 Design System

🤖 AI Models

🇮🇳 Built for India

📸 How It Works

🛠️ Scripts

🤝 Contributing

📄 License

⭐ Star this repo if Shadow Founder helped you validate your idea!

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages