Skip to content

BUNDLE_REGISTRY_FEATURE.md

Latest commit

 

History

History
223 lines (172 loc) · 5.61 KB

BUNDLE_REGISTRY_FEATURE.md

File metadata and controls

223 lines (172 loc) · 5.61 KB
Raw

🎉 Bundle Registry Feature - Complete!

✅ What Was Added

New Component: Bundle Registry Browser

A beautiful, searchable grid that displays ALL available bundles including:

  • ✅ Weekly pre-indexed bundles (numpy, pandas, fastapi, requests, flask)
  • ✅ On-demand generated bundles (flask, httpx - the ones you just created!)

📍 Where to Find Your Bundles

On Your Website:

Once deployed, you'll see a new section called "Pre-indexed Repositories" with:

  1. Search bar - Search by name, repository, or description
  2. Category tabs - Filter by: All, Data Science, Web Framework, HTTP Client, etc.
  3. Bundle cards showing:
    • Repository name and description
    • GitHub stars
    • Bundle size
    • Generated date
    • Version and commit
    • Download button
    • Usage command (cgc load ...)

Your Flask & HTTPX Bundles:

They're now visible in the registry! Each shows:

  • flask - Lightweight WSGI web application framework
  • httpx - Next generation HTTP client for Python

🎨 Page Layout (Updated)

Landing Page:
├── Hero Section
├── Demo Section
├── Comparison Table
├── Features Section
├── Installation Section
├── 🆕 Bundle Registry (Browse all bundles)    ← NEW!
├── 🆕 Bundle Generator (Create custom bundles) ← NEW!
├── Examples Section
├── Testimonial Section
├── Cookbook Section
├── Social Mentions
└── Footer

🔧 Files Created/Modified

New Files:

  1. ✅ website/src/components/BundleRegistrySection.tsx - Registry UI
  2. ✅ website/api/bundles.ts - API to fetch bundles from GitHub

Modified Files:

  1. ✅ website/src/pages/Index.tsx - Added registry to page

📊 How It Works

Development Mode (Local):

  • Shows mock data (5 sample bundles)
  • Blue banner: "Development Mode: Showing mock bundle data"
  • No API calls needed

Production Mode (Deployed):

  1. Calls /api/bundles endpoint
  2. Endpoint fetches from:
    • On-demand manifest (manifest.json in on-demand-bundles release)
    • Weekly releases (releases with tag bundles-YYYYMMDD)
  3. Combines and deduplicates bundles
  4. Returns to UI for display

🎯 What Users See

Bundle Card Example (Flask):

┌─────────────────────────────────────────┐
│ flask                    [Web Framework] │
│ pallets/flask                            │
│                                          │
│ Lightweight WSGI web application         │
│ framework                                │
│                                          │
│ ⭐ 65.0k    💾 12MB                      │
│ 📅 1/21/2026                             │
│                                          │
│ [v3.0.0] [abc123]                        │
│                                          │
│ [⬇️ Download Bundle]                     │
│                                          │
│ cgc load flask-3.0.0.cgc                 │
└─────────────────────────────────────────┘

🚀 To See Your Bundles

Option 1: Deploy to Production

cd website
vercel --prod

Then visit your website and scroll to "Pre-indexed Repositories"

Option 2: Check GitHub Directly

  1. Go to: https://github.com/CodeGraphContext/CodeGraphContext/releases
  2. Find release: on-demand-bundles
  3. Download manifest.json
  4. You'll see flask and httpx listed there!

🔍 Features

Search:

  • Type "flask" → Shows flask bundle
  • Type "http" → Shows httpx and requests
  • Type "web" → Shows fastapi and flask

Filter by Category:

  • All - Shows everything
  • Data Science - numpy, pandas
  • Web Framework - fastapi, flask
  • HTTP Client - requests, httpx

Bundle Information:

  • Repository name and owner
  • Description
  • GitHub stars
  • Bundle file size
  • Generation date
  • Version tag
  • Commit hash
  • Direct download link
  • Usage command

📝 API Endpoint Details

GET /api/bundles

Response:

{
  "bundles": [
    {
      "name": "flask",
      "repo": "pallets/flask",
      "bundle_name": "flask-3.0.0-abc123.cgc",
      "version": "3.0.0",
      "commit": "abc123",
      "size": "12MB",
      "download_url": "https://github.com/.../flask-3.0.0-abc123.cgc",
      "generated_at": "2026-01-21T...",
      "category": "Web Framework",
      "description": "Lightweight WSGI web application framework",
      "stars": 65000,
      "source": "on-demand"
    },
    {
      "name": "httpx",
      "repo": "encode/httpx",
      ...
    }
  ],
  "total": 7,
  "updated_at": "2026-01-21T..."
}

🎉 Summary

Before:

  • ❌ Generated bundles (flask, httpx) were invisible
  • ❌ No way to browse available bundles
  • ❌ Users had to manually find download links

After:

  • ✅ Beautiful registry showing ALL bundles
  • ✅ Search and filter functionality
  • ✅ Flask and httpx bundles are visible
  • ✅ One-click download for each bundle
  • ✅ Usage instructions included

🚀 Next Steps

  1. Deploy to Vercel to see the registry in action
  2. Generate more bundles - they'll automatically appear
  3. Share the registry with users

Your bundles are ready and waiting to be discovered! 🎊

Once you deploy, users can:

  1. Browse the registry
  2. Find flask and httpx
  3. Download with one click
  4. Load instantly with cgc load

Perfect! 🚀