https://github.com/incubrain/product-validator
Product Validator is an opinionated nuxt 4 standards driven template with the sole purpose of identifying 'should I invest time/resources/money to create this thing?'
https://github.com/incubrain/product-validator
building nuxt nuxt4 nuxtjs product product-validator tailwindcss validation vue
Last synced: 8 months ago
JSON representation
Product Validator is an opinionated nuxt 4 standards driven template with the sole purpose of identifying 'should I invest time/resources/money to create this thing?'
- Host: GitHub
- URL: https://github.com/incubrain/product-validator
- Owner: incubrain
- Created: 2022-11-07T09:37:50.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-10-06T05:05:34.000Z (8 months ago)
- Last Synced: 2025-10-06T06:42:34.525Z (8 months ago)
- Topics: building, nuxt, nuxt4, nuxtjs, product, product-validator, tailwindcss, validation, vue
- Language: TypeScript
- Homepage: https://product-validator.incubrain.org/
- Size: 46.5 MB
- Stars: 71
- Watchers: 4
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Product Validator
> **⚠️ Validation-first Template** — Ship a landing page in <1 hour, validate in
> weeks, not months.
A minimal, production-ready **Nuxt 4 + Tailwind v4 + TypeScript** template
designed to help struggling founders break perfectionist cycles and validate
ideas through action.
**Core Philosophy:** You are the product. You are the customer. Ship signal, not
perfection.
---
## 🌐 Live Demo
See the template in action:
[product-validator.incubrain.org](https://product-validator.incubrain.org)
---
## ✨ Why This Template Exists
Most founders get stuck in perfectionist loops:
- "Just one more feature..."
- "I need to research more first..."
- "It's not ready to show anyone yet..."
**This template forces a different path:**
1. **Deploy with placeholders** (break the "not ready" barrier)
2. **AI-guided introspection** (discover what you're uniquely positioned to
build)
3. **Package your offer** (structure your Launch Kit based on your positioning)
4. **Ship real content** (replace placeholders with validated messaging)
5. **Get feedback** (recorded YouTube critique + strategic guidance)
**Total time investment:** 8-12 hours → Live validated landing page
---
## 🎯 What's Included
### For Founders (Validation Features)
**Free Launch Kit** — 4-step email sequence that guides you from placeholder
site to validated landing page:
- ✅ Automated email delivery with progressive content
- ✅ AI-guided positioning discovery (speech-to-text optimized)
- ✅ Competitive analysis and differentiation framework
- ✅ Config file generation from your unique context
- ✅ 30-min recorded YouTube feedback call
- ✅ Support community access throughout
**Total time:** 8-12 hours over 1-4 weeks
### For Developers (Technical Features)
- **Modern Stack:** Nuxt 4, Tailwind v4, TypeScript
- **Conversion Systems:** Exit-intent modals, progressive forms, CTA
optimization
- **Analytics Ready:** Provider-agnostic event system (pre-configured for Umami)
- **Email Automation:** Integrated with FilloutForm for sequence delivery
- **Type-Safe Config:** Structured data model with inline documentation
- **One-Click Deploy:** Railway and Vercel support out of the box
- **Hot Module Replacement:** Config changes without page reload
---
## 🚀 Quick Start
### Option A: One-Click Deploy (Fastest)
**Vercel:**
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fincubrain%2Fproduct-validator)
**Railway:**
[](https://railway.com/deploy/usbhW2?referralCode=gvXQKE)
**Your site goes live with placeholder content in <10 minutes.**
---
### Option B: Clone First (Recommended for Developers)
```bash
# Clone repository
git clone https://github.com/incubrain/product-validator your-project
cd your-project
# Install dependencies
pnpm install
# Start dev server
pnpm dev
```
Visit `http://localhost:3000` to see placeholder site.
---
## 📚 Documentation
### Guides (For Founders)
**Getting Started:**
- [Step 1: Deployment](guides/1.deployment.md) — Get live with placeholders
in <1 hour
- [FilloutForm Setup](guides/fillout-setup.md) — Automate your Launch Kit email
sequence
**After Launch Kit Completion:**
- [Step 4: Configuration](guides/step-4-configuration.md) — Replace placeholders
with AI-generated content
- [Analytics Setup](guides/analytics-setup.md) — Track conversions (setup AFTER
feedback call)
### System Prompts (AI Guides)
Attached to Launch Kit emails, used in your AI project
(ChatGPT/Claude/Gemini/Grok):
- **Step 2:** Introspection Guide (deep positioning discovery)
- **Step 3:** Positioning + Offer Packaging (competitive analysis)
- **Step 4:** Config Generation (transform context into production files)
### Configuration
All landing page content is managed through structured config files in
`shared/config/`.
**To customize your site:** Update the config files with your content. Each file
has inline comments explaining what it needs and where that information comes
from (Step 2 or 3 of the Launch Kit).
**After completing the Launch Kit:** AI will generate completed config files
based on your introspection and positioning work. Simply copy them into your
codebase and deploy.
---
## 🎯 Who This Is For
**Ideal for:**
- Technical founders stuck in "almost ready" mode for 3-10+ years
- Founders with domain expertise but can't identify what to build
- Those who keep rebuilding instead of validating
- People tired of perfectionist loops preventing launches
**Not ideal for:**
- Post-PMF companies scaling existing products
- B2B enterprise with long sales cycles
- Non-technical founders without dev support
- Anyone expecting passive validation without marketing effort
---
## 🏗️ Why This Approach Works
### Email Sequence (Not PDFs/Videos)
- Fastest format to deliver value
- No production overhead (write text, automate delivery)
- Progressive value delivery (each step builds on previous)
- Easy to iterate based on feedback
### AI-Guided (Not Worksheets)
- Recognizes patterns you're too close to see
- Pushes for specificity when answers are vague
- Speech-to-text optimized (think out loud, AI extracts signal)
- Replaces expensive coaching or mastermind groups
### Placeholder-First Deployment
- Breaks perfectionism by forcing public iteration from day one
- Removes the "not ready yet" excuse
- Tests messaging before investing in design
- Psychological shift from private iteration to public learning
### Structured Config (Not CMS)
- Single-page validation doesn't need content management
- Version controlled (Git history of messaging iterations)
- Type-safe (catches errors at compile-time)
- Fast (no database queries, pure static generation)
---
## 🔎 Quick Navigation
Use inline tags to find what you need quickly:
**Search:** `Cmd+Shift+F` → `{CONFIG}:` (things you must update)
**Other tags:**
- `{OPTIMIZE}` — Post-validation improvements to consider
- `{DECISION}` — Why something was implemented this way
- `{DX}` — Developer experience tips
---
## ⚡ Quick Reference
| Action | Command / Location |
| ------------- | ------------------------------------------------------ |
| **Deploy** | Push to main branch (Railway/Vercel auto-deploy) |
| **Configure** | Update files in `shared/config/` |
| **Guides** | See `guides/` directory |
| **Analytics** | Setup AFTER feedback call (see guide) |
| **Support** | [Community Chat](https://whop.com/incubrain-community) |
---
## 🤝 Contributing
This template evolves based on real founder feedback.
**Ways to contribute:**
- Submit your site for YouTube review
- Share validation results (anonymized if needed)
- Report bugs or unclear documentation
- Suggest improvements based on your experience
**Not accepting:** Feature requests that add complexity before validation.
---
## 🔗 Links
- **Live Demo:**
[product-validator.incubrain.org](https://product-validator.incubrain.org)
- **YouTube Reviews:** [Incubrain Channel](https://www.youtube.com/@Incubrain)
- **Support Community:** [Join Chat](https://whop.com/incubrain-community)
- **Repository:** [GitHub](https://github.com/incubrain/product-validator)
---
## 📄 License
MIT License — Use for personal or commercial projects.
---
**Focus:** Ship signal, not perfection. Validate in weeks, not months.