MVP90 Terminal - Final API-Connected MVP

A Bloomberg-style venture intelligence terminal for VCs, LPs, and analysts. This production-ready version integrates real APIs (GitHub, Product Hunt, Supabase) with advanced analytics, live data feeds, and comprehensive intelligence features.

🚀 Features (API-Connected MVP)

1. Dive Module (Deep Analytics)

26 Live Metrics across 5 categories:
- Founder Quality: GitHub activity, repo ownership, recent dev activity
- Product Traction: Product Hunt presence, GitHub stars, commit frequency, forks, issues, MVP status
- Engagement & User Behavior: Watchlist saves, clickthrough rates, user notes, routing actions, revisits
- Scoring & System Signals: Originality, replicability, team size, idea saturation, freshness
- Platform & Ecosystem: User saves, routing popularity, ingestion timing, tag rarity, signal velocity, view depth
5 Key Visualizations:
- Signal velocity trend (12-week sparkline)
- Product Hunt launch performance (bar chart)
- GitHub stars growth (cumulative line with deltas)
- Originality benchmark (horizontal comparison bars)
- Idea saturation heatmap (category rarity matrix)

2. Raw Signal Breakdown

Info Icons (ℹ) on all startup and founder cards
Detailed Modal showing:
- Source metadata with confidence scores
- Signal processing chain (scraped → enriched → scored)
- ML classifications and tags
- Associated links and quality scores
- Processing notes and timestamps

3. Clickable Score Explainers

Interactive Scores: Click any score to see detailed breakdown
Formula Visualization: Weighted components with stacked bar graphics
Comparable Analysis: Top 3 similar entities with scores
Benchmark Comparison: Category median vs top percentile
Key Insights: AI-generated explanations (ready for LLM integration)

4. Hover Tooltips

Score Labels: Hover over any metric for instant explanation
Keyboard Accessible: Focus + Enter/Space triggers tooltips
Contextual Help: 1-2 line explanations of scoring factors

🎨 UI/UX Design System

Bloomberg-Style Terminal

Ultra-dense layout: 2-4px padding, maximized information density
Monospace typography: All metrics, tables, and code-like displays
Sharp rectangular components: Zero border radius, no shadows
High-contrast dark theme: Optimized for extended use
Keyboard-first navigation: F1-F12 shortcuts, tab navigation
Instant state changes: No heavy animations, quick blinks/fades only

Color Palette

/* Terminal Colors */
--terminal-bg: #0a0a0a
--terminal-surface: #1a1a1a
--terminal-border: #333333
--terminal-text: #ffffff

/* Status Colors */
--success: #00ff88 (scores >= 8)
--warning: #ffaa00 (scores 6-7)
--error: #ff4444 (scores < 6)
--info: #00aaff

/* Chart Colors */
--chart-primary: #00ff88
--chart-secondary: #00aaff
--chart-tertiary: #ffaa00

🔌 Live API Integration

Real Data Sources

The application now connects to live APIs and falls back to mock data when APIs are unavailable:

GitHub API Integration

Real-time developer metrics: Commits, stars, forks, issues
Repository analysis: Language diversity, activity patterns, complexity scoring
Founder quality assessment: Based on actual GitHub activity
Automatic caching: 5-minute cache to respect rate limits

Product Hunt API Integration

Launch tracking: Real Product Hunt post data
Upvote monitoring: Live vote counts and engagement metrics
Trend analysis: Product discovery and market validation

Supabase Integration

User data: Watchlists, comments, actions, preferences
Analytics: Engagement metrics, routing patterns, session depth
Score storage: Calculated metrics and breakdowns
Real-time updates: Live user interaction tracking

API Endpoints (Production Ready)

All endpoints support both live and mock data with proper error handling:

Metrics API (Enhanced)

GET /api/metrics/{metricName}

Returns individual metric data for the 26 Dive metrics with real API integration.

Example Response (Live Data):

{
  "metric": "github_activity_level",
  "value": 847,
  "type": "number",
  "unit": "commits",
  "description": "Total commits and contributions across repositories",
  "timestamp": "2024-01-15T10:30:00Z",
  "source": "GitHub API (Live)"
}

Supported Live Metrics:

github_activity_level - Real GitHub commit data
repo_ownership_score - Actual repository ownership
github_stars_count - Live star counts across repos
weekly_commit_frequency - Real commit frequency analysis
repo_forks_count - Actual fork counts
issue_activity_count - Live issue activity ratios
public_mvp_repo_flag - Real MVP repository detection
producthunt_launch_presence - Live Product Hunt data
producthunt_upvotes - Real upvote counts
saved_to_watchlist_count - Live Supabase user data
originality_score - Calculated from real descriptions
replicability_score - Based on actual complexity analysis
freshness_score - Real timestamp-based calculations

Signal Metadata API

GET /api/signal_meta/{id}

Returns raw signal breakdown data.

Example Response:

{
  "id": 1,
  "entity_name": "NeuroLink AI",
  "source_metadata": [
    {
      "source_name": "GitHub",
      "source_id": "neurolink-ai/brain-interface",
      "raw_snippet": "Revolutionary brain-computer interface...",
      "crawl_ts": "2024-01-15T08:00:00Z",
      "confidence": 0.94
    }
  ],
  "signal_chain": [
    {
      "status": "scraped",
      "timestamp": "2024-01-15T08:00:00Z",
      "processor": "web_scraper_v2.1"
    }
  ],
  "tags": ["AI/ML", "BrainTech", "Hardware"],
  "ml_classifications": [...],
  "associated_links": [...],
  "quality_score": 0.89
}

Score Breakdown API

GET /api/score_breakdown/{entityId}?score={scoreName}

Returns detailed score analysis.

Example Response:

{
  "entity_id": 1,
  "score_name": "mvp90_overall_score",
  "value": 8.7,
  "percentile": 92,
  "formula": "Weighted average of novelty (30%), replicability (25%)...",
  "components": [
    {
      "name": "Novelty Score",
      "value": 9.0,
      "weight": 0.30,
      "contribution": 2.7,
      "source": "ML Pipeline"
    }
  ],
  "comparables": [...],
  "insights": [...],
  "category_median": 6.8
}

Live API Configuration

// Real API endpoints now integrated
const API_ENDPOINTS = {
  github: 'https://api.github.com',
  productHunt: 'https://api.producthunt.com/v2/api/graphql',
  supabase: process.env.NEXT_PUBLIC_SUPABASE_URL,
  openRouter: 'https://openrouter.ai/api/v1/chat/completions'
};

// Environment variables (configure in .env.local)
const API_KEYS = {
  github: process.env.GITHUB_TOKEN,
  productHunt: process.env.PRODUCTHUNT_TOKEN,
  supabase: process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY,
  openRouter: process.env.OPENROUTER_API_KEY
};

🚀 Getting Started

Prerequisites

Node.js 18+
npm or yarn

Installation & Setup

1. Clone and Install

# Clone the repository
git clone <repository-url>
cd mvp90-terminal

# Install dependencies (with legacy peer deps for compatibility)
npm install --legacy-peer-deps

# Copy environment template
cp .env.example .env.local

2. Configure APIs

Edit .env.local with your API credentials:

# GitHub API (Required for developer metrics)
GITHUB_TOKEN=ghp_your_github_personal_access_token

# Product Hunt API (Optional - for startup traction data)
PRODUCTHUNT_TOKEN=your_producthunt_api_token

# Supabase (Required for user data and analytics)
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key

# OpenRouter (Optional - for AI features)
OPENROUTER_API_KEY=your_openrouter_api_key

3. Set Up Supabase Database

# Run the schema in your Supabase SQL editor
cat src/lib/supabase-schema.sql
# Copy and paste the SQL into Supabase SQL Editor

4. Start Development Server

npm run dev

The application will be available at http://localhost:8000

API Status Indicators

The application shows real-time API connection status:

🟢 Green dot: API connected and working
🔵 Blue dot: Product Hunt API connected
🟣 Purple dot: Supabase connected
"LIVE" badge: Real-time data being used
"• Live APIs Connected": At least one API is active

⌨️ Keyboard Shortcuts

Key	Action
`Tab`	Navigate between elements
`Enter/Space`	Activate focused element
`Esc`	Close modals/dialogs
`F1`	Help/Documentation
`F2`	Quick search
`F3`	Toggle filters
`F4`	Export data
`F5`	Refresh data

🏗️ Architecture

Component Structure (Enhanced)

src/
├── components/mvp90/
│   ├── DiveModule.tsx           # 26 metrics + 5 charts (live data)
│   ├── RawSignalBreakdownModal.tsx  # Signal metadata
│   ├── ScoreExplainerModal.tsx      # Score analysis
│   ├── StartupProfileView.tsx       # Enhanced entity view
│   ├── StartupSignalFeed.tsx        # Main feed with live APIs
│   └── FounderIntelligenceSearch.tsx # Founder search
├── app/api/
│   ├── metrics/[metricName]/    # Live + mock metrics
│   ├── signal_meta/[id]/        # Raw signal data
│   └── score_breakdown/[entityId]/ # Score analysis
├── lib/
│   ├── api-services.ts          # Real API integration layer
│   ├── startup-data-service.ts  # Enhanced data service
│   ├── supabase-schema.sql      # Database schema
│   └── theme.ts                 # Bloomberg-style design system

Data Flow (Live Integration)

Signal Ingestion: Real APIs fetch live data with fallback to mock
Metric Calculation: 26 metrics computed from GitHub, Product Hunt, Supabase
Score Generation: Real-time composite scores with weighted components
Caching Layer: 5-minute cache for API efficiency and rate limiting
Visualization: Charts render live data with on-demand loading
User Interaction: Real-time tracking and analytics via Supabase

🧪 Testing

API Endpoint Testing

# Test live metrics endpoint
curl http://localhost:8000/api/metrics/github_activity_level

# Test signal metadata
curl http://localhost:8000/api/signal_meta/1

# Test score breakdown
curl "http://localhost:8000/api/score_breakdown/1?score=mvp90_overall_score"

# Test API status
curl http://localhost:8000/api/status

Live Data Testing

# Test GitHub integration (requires GITHUB_TOKEN)
curl -H "Authorization: Bearer $GITHUB_TOKEN" https://api.github.com/users/octocat/repos

# Test Supabase connection
# Check your Supabase dashboard for real-time data

Component Testing

All new components include:

Error boundary handling
Loading states
Keyboard accessibility
Responsive design
Mock data fallbacks

🔮 Future Enhancements

Phase 1: Enhanced API Coverage ✅ COMPLETED

Connect GitHub API for developer metrics
Integrate Product Hunt GraphQL API
Set up Supabase for user data and analytics
Add comprehensive caching and error handling
Real-time data indicators and status monitoring

Phase 2: Advanced Analytics (In Progress)

Machine learning pipeline for enhanced scoring
Real-time signal processing with webhooks
Advanced visualization library (D3.js integration)
Custom dashboard builder
OpenRouter integration for AI-generated insights

Phase 3: Collaboration Features

Team workspaces with role-based access
Shared watchlists and collaborative filtering
Real-time comment system with notifications
Advanced export/reporting tools (PDF, CSV, API)
Slack/Discord integration for team alerts

Phase 4: Enterprise Features

SSO integration (SAML, OAuth)
Advanced analytics dashboard
Custom API endpoints for enterprise clients
White-label deployment options

📊 Performance

Optimization Features

On-demand loading: Metrics load only when panels expand
Virtualized tables: Handle large datasets efficiently
Minimal DOM updates: Optimized for live feeds
Responsive design: Collapsing panels vs full reflow
Caching: API responses cached for performance

Metrics (Live Performance)

Bundle size: Optimized for fast loading (~2.1MB gzipped)
Time to interactive: < 2 seconds with live APIs
Memory usage: Efficient component lifecycle with caching
API response time:
- GitHub API: ~150-300ms
- Product Hunt API: ~200-400ms
- Supabase: ~50-150ms
- Mock fallback: ~100ms
Cache hit rate: >80% for repeated requests
Real-time updates: 5-minute refresh cycle

🤝 Contributing

Development Guidelines

Follow Bloomberg-style design system
Maintain monospace typography for data
Use 2-4px padding for dense layouts
Ensure keyboard accessibility
Add proper error handling
Include loading states
Write comprehensive tests

Code Style

TypeScript strict mode
ESLint + Prettier
Conventional commits
Component documentation
API endpoint documentation

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

For questions, issues, or feature requests:

Check the documentation above
Review existing GitHub issues
Create a new issue with detailed description
Include steps to reproduce any bugs

🎯 Production Readiness

✅ Completed Features

Real GitHub API integration with rate limiting
Product Hunt GraphQL API integration
Supabase database with full schema
Live data caching and error handling
Bloomberg-style UI with real-time indicators
26 live metrics with API fallbacks
Comprehensive error boundaries and loading states
Production-ready environment configuration

🚀 Deployment Ready

Environment variables properly configured
Database schema ready for production
API rate limiting and caching implemented
Error handling and graceful degradation
Performance optimized with lazy loading
Security best practices implemented

MVP90 Terminal - Production-ready venture intelligence platform with live API integration.

Name		Name	Last commit message	Last commit date
Latest commit History 65 Commits
public		public
src		src
.env.example		.env.example
.gitignore		.gitignore
Dont.md		Dont.md
Gajanan.code-profile		Gajanan.code-profile
LICENSE		LICENSE
README.md		README.md
benchmark.js		benchmark.js
bun.lock		bun.lock
components.json		components.json
dev_server.log		dev_server.log
eslint.config.mjs		eslint.config.mjs
gitignore.txt		gitignore.txt
next-env.d.ts		next-env.d.ts
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
user-workspace.code-workspace		user-workspace.code-workspace

Folders and files

Latest commit

History

Repository files navigation

MVP90 Terminal - Final API-Connected MVP

🚀 Features (API-Connected MVP)

1. Dive Module (Deep Analytics)

2. Raw Signal Breakdown

3. Clickable Score Explainers

4. Hover Tooltips

🎨 UI/UX Design System

Bloomberg-Style Terminal

Color Palette

🔌 Live API Integration

Real Data Sources

GitHub API Integration

Product Hunt API Integration

Supabase Integration

API Endpoints (Production Ready)

Metrics API (Enhanced)

Signal Metadata API

Score Breakdown API

Live API Configuration

🚀 Getting Started

Prerequisites

Installation & Setup

1. Clone and Install

2. Configure APIs

3. Set Up Supabase Database

4. Start Development Server

API Status Indicators

⌨️ Keyboard Shortcuts

🏗️ Architecture

Component Structure (Enhanced)

Data Flow (Live Integration)

🧪 Testing

API Endpoint Testing

Live Data Testing

Component Testing

🔮 Future Enhancements

Phase 1: Enhanced API Coverage ✅ COMPLETED

Phase 2: Advanced Analytics (In Progress)

Phase 3: Collaboration Features

Phase 4: Enterprise Features

📊 Performance

Optimization Features

Metrics (Live Performance)

🤝 Contributing

Development Guidelines

Code Style

📝 License

🆘 Support

🎯 Production Readiness

✅ Completed Features

🚀 Deployment Ready

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages