The All-in-One AI-Powered Platform for Modern Startup Teams
🌐 Live Demo • 📖 Documentation • 🚀 Quick Start • 🤝 Contributing
GhostFounder is a comprehensive startup toolkit that combines AI-powered automation with blockchain technology to help founders move fast. Whether you're building an MVP, preparing for fundraising, or scaling your team, GhostFounder has you covered.
| Challenge | GhostFounder Solution |
|---|---|
| Code quality at speed | 🛡️ Code Police - Automated AI code reviews on every commit |
| Investor-ready decks | 📊 Pitch Deck Studio - Generate professional decks from README |
| Equity management | 💰 Equity Distribution - Blockchain-based token management |
| Database complexity | 💾 Database Agent - Natural language database queries |
AI-Powered Code Review System
- Automated Analysis: Reviews code on every push and PR
- Multi-Category Detection: Security, performance, bugs, readability, style
- Severity Classification: Critical, high, medium, low, info
- Email Reports: Professional HTML reports with actionable insights
- GitHub Integration: Webhook-based real-time automation
📖 Full Documentation | Quick Reference
AI-Powered Presentation Generator
- GitHub-to-Deck: Generates investor-grade decks from your README
- Multiple Templates: Pre-seed, Seed, Series A, Demo Day styles
- Visual Editor: Drag-and-drop slide canvas with real-time preview
- AI Content: Generates headlines, bullets, metrics from your project
- Export Options: PDF and image export capabilities
- Gap Analysis: Identifies missing slides and content improvements
Blockchain-Based Token Management
- ERC-20 Tokens: Custom equity tokens on Ethereum Sepolia
- Percentage Transfers: Simple percentage-based equity distribution
- MetaMask Integration: Seamless Web3 wallet connection
- Real-Time Tracking: Monitor balances and ownership percentages
- Cap Table: Transparent, on-chain ownership records
Natural Language Database Interface
- Multi-Database Support: PostgreSQL, MySQL, MongoDB
- AI Query Generation: Natural language to SQL/NoSQL
- Security First: AES-256 encrypted credentials
- Query Explanation: Understand what each query does
- Safe Execution: Read-only queries with validation
📖 Full Documentation | Quick Reference
- Node.js 20.x or higher
- npm 10.x or higher
- Git for version control
# 1. Clone the repository
git clone https://github.com/yourusername/ghostfounder.git
cd ghostfounder
# 2. Install dependencies
npm install
# 3. Set up environment variables
cp .env.example .env.local
# Edit .env.local with your credentials
# 4. Validate configuration
npm run validate-env
# 5. Start development server
npm run devOpen http://localhost:3000 in your browser.
Quick Steps:
- Click the Deploy button above
- Connect your GitHub account
- Add required environment variables
- Deploy automatically!
📖 Full Guide: Railway Deployment | Deployment Checklist
|
|
|
|
|
| Category | Technologies |
|---|---|
| Framework | Next.js 16.1 (App Router), React 19 |
| Language | TypeScript 5.x |
| Authentication | Clerk |
| Database | Firebase Firestore |
| Blockchain | Ethereum Sepolia, ethers.js, Hardhat |
| AI/ML | Google Gemini 2.0 Flash, LangChain |
| Styling | Tailwind CSS 4.0, Framer Motion |
| UI Components | Radix UI, Lucide Icons |
| Resend | |
| Deployment | Railway, Netlify |
# Development
npm run dev # Start dev server with hot reload
npm run build # Build for production (validates env first)
npm run start # Start production server
npm run lint # Run ESLint
npm run lint:fix # Auto-fix linting issues
npm run type-check # TypeScript type checking
npm run validate-env # Validate environment variables
# Smart Contracts (optional)
npx hardhat compile # Compile Solidity contracts
npx hardhat test # Run contract tests
npx hardhat run scripts/deploy.js --network sepolia # Deploy to Sepolia# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_live_xxxxx
CLERK_SECRET_KEY=sk_live_xxxxx
# Firebase (Client)
NEXT_PUBLIC_FIREBASE_API_KEY=AIza...
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your-app.firebaseapp.com
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your-project-id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your-app.appspot.com
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=123456789
NEXT_PUBLIC_FIREBASE_APP_ID=1:123456789:web:xxxxx
# Firebase Admin (Server)
FIREBASE_PROJECT_ID=your-project-id
FIREBASE_CLIENT_EMAIL=firebase-adminsdk@your-project.iam.gserviceaccount.com
FIREBASE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"# GitHub Integration (Code Police)
GITHUB_CLIENT_ID=Iv1.xxxxx
GITHUB_CLIENT_SECRET=xxxxx
GITHUB_WEBHOOK_SECRET=xxxxx
# AI Services
GOOGLE_API_KEY=AIza...
# Email (Resend)
RESEND_API_KEY=re_xxxxx
# Blockchain (Equity Distribution)
NEXT_PUBLIC_SEPOLIA_RPC_URL=https://sepolia.infura.io/v3/your-key
NEXT_PUBLIC_EQUITY_TOKEN_ADDRESS=0x...
SEPOLIA_PRIVATE_KEY=xxxxx
# Application
NEXT_PUBLIC_APP_URL=https://your-app.up.railway.app
NODE_ENV=productionSee .env.example for the complete template.
ghostfounder/
├── 📂 src/
│ ├── 📂 app/ # Next.js App Router
│ │ ├── 📂 api/ # API Routes
│ │ │ ├── 📂 auth/ # Authentication endpoints
│ │ │ ├── 📂 code-police/ # Code review API
│ │ │ ├── 📂 database/ # Database agent API
│ │ │ ├── 📂 equity/ # Blockchain API
│ │ │ ├── 📂 pitch-deck/ # Deck generation API
│ │ │ └── 📂 webhooks/ # GitHub webhooks
│ │ ├── 📂 dashboard/ # Protected dashboard pages
│ │ │ ├── 📂 code-police/ # Code review UI
│ │ │ ├── 📂 database/ # Database agent UI
│ │ │ ├── 📂 equity/ # Equity management UI
│ │ │ └── 📂 pitch-deck/ # Deck editor UI
│ │ ├── 📄 layout.tsx # Root layout
│ │ └── 📄 page.tsx # Landing page
│ ├── 📂 components/ # React components
│ │ ├── 📂 code-police/ # Code review components
│ │ ├── 📂 equity/ # Blockchain components
│ │ ├── 📂 pitch-deck/ # Deck editor components
│ │ └── 📂 ui/ # Shared UI components
│ ├── 📂 lib/ # Utilities and services
│ │ ├── 📂 agents/ # AI agent implementations
│ │ ├── 📂 db/ # Database utilities
│ │ ├── 📂 firebase/ # Firebase configuration
│ │ └── 📂 pitch-deck/ # Deck generation logic
│ └── 📂 types/ # TypeScript definitions
├── 📂 contracts/ # Solidity smart contracts
│ └── 📄 EquityToken.sol # ERC-20 equity token
├── 📂 scripts/ # Build and deploy scripts
│ ├── 📄 deploy.js # Contract deployment
│ └── 📄 validate-env.js # Environment validation
├── 📂 public/ # Static assets
├── 📄 firebase.json # Firebase configuration
├── 📄 firestore.rules # Firestore security rules
├── 📄 hardhat.config.js # Hardhat configuration
├── 📄 railway.json # Railway deployment config
└── 📄 package.json # Dependencies
- 📘 Setup Guide - Complete local setup instructions
- 🚀 Railway Deployment - Production deployment
- ✅ Deployment Checklist - Pre-deployment checks
- 🛡️ Code Police - AI code review system
- 🛡️ Code Police Quick Reference - Quick setup guide
- 📊 Pitch Deck Studio - Deck generator documentation
- 💰 Equity Distribution - Blockchain equity system
- 💾 Database Agent - Natural language queries
- 💾 Database Agent Technical Guide - Deep dive
- 🏗️ Architecture Overview - System design and patterns
- 🔌 API Reference - Complete API documentation
- 🤖 AI Model Reference - AI/ML implementation details
We welcome contributions! Please see our Contributing Guide for details.
# 1. Fork the repository
# 2. Create a feature branch
git checkout -b feature/amazing-feature
# 3. Make your changes
# 4. Run tests and linting
npm run lint && npm run type-check
# 5. Commit your changes
git commit -m "feat: add amazing feature"
# 6. Push to your fork
git push origin feature/amazing-feature
# 7. Open a Pull Request- Follow Conventional Commits
- Write TypeScript with strict mode
- Add tests for new features
- Update documentation as needed
This project is licensed under the MIT License - see the LICENSE file for details.
- 🐛 Bug Reports: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📧 Email: support@ghostfounder.com
- 📖 Documentation: See docs in this repository
- Next.js - The React framework
- Clerk - Authentication & user management
- Firebase - Backend-as-a-service
- LangChain - AI application framework
- Google Gemini - AI language model
- Railway - Deployment platform
Built with ❤️ for founders who move fast