// share.gitpitcher.com
Git PitcherBuild Pack WebpageShared artifact
April 26, 2026

Build blueprint

Build a managed globe platform for ambassador programs, with auth, profiles, and analytics, monetized via subscription.

Provide organizations with a managed, customizable, and interactive globe to showcase their global ambassadors, partners, or chapters.

This version is optimized for builders. It breaks the product into entities, routes, modules, implementation phases, and practical first moves you can actually execute.

MVP scope

8

Entities

3

Flows

5

Phases

5

Blueprint

Product thesis and MVP scope

Provide organizations with a managed, customizable, and interactive globe to showcase their global ambassadors, partners, or chapters.

Target user

Community managers and event organizers at technology companies with ambassador programs.

MVP scope

  • Interactive 3D globe displaying ambassador locations with auto-rotation and pause-on-hover.
  • Ambassador profile cards on click (name, country, bio, social links, avatar).
  • Continent and country filters with a toggle to grid view grouped by geography.
  • Authentication for admins via email/password or GitHub OAuth.
  • Admin panel to add, edit, or remove ambassadors (name, location, photo, links).
  • Static events page showing upcoming events with a separate events globe.
  • Custom subdomain for each organization (e.g., org.codexglobe.com).
  • Vercel Analytics integration to track page views and interactions.

System

Entities, flows, and modules

Entities

Ambassador

id, name, latitude, longitude, country, continent, bio, avatar, social_links, organization_id — Core entity; location drives globe markers; social links include GitHub, Twitter, website.

Organization

id, name, slug, subscription_tier, ambassador_count, custom_domain, created_at — Each organization represents a tenant with its own ambassador list and subdomain.

Event

id, title, description, date, latitude, longitude, location, organization_id — Used for events globe feature; linked to organization.

Flows

Public Globe Dashboard

/[orgSlug] — Main interactive globe page showing ambassadors of a specific organization.

Events Globe

/[orgSlug]/events — Separate globe view filtering events with list/grid toggle.

Admin Login & Dashboard

/admin — Auth gate; redirects to ambassador CRUD interface after login.

Ambassador Management

/admin/ambassadors — Table listing ambassadors with add/edit/delete actions using shadcn/ui forms.

Landing Page

/ — Marketing page for the hosted platform, pricing, and sign‑up.

Backend modules

Ambassador Service

CRUD operations for ambassadors, geocoding lookup or manual lat/lng entry, validation. — Without this, the globe remains static; it is the core data layer.

Auth Service

NextAuth‑based authentication, organization‑scoped access, session management. — Multi‑tenant isolation and admin access are impossible without auth.

Subscription Service

Stripe integration, metered billing per ambassador, plan management webhooks. — Monetization road requires a billing engine; this enables the paid tiers.

Analytics Service

Capture page views, click events on ambassadors, and funnel data for customer reporting. — Value proposition for organizations is data; basic analytics justify premium tiers.

Phases

Implementation phases

Phase 1

Phase 1 — Rebuild Static Globe

Reproduce existing globe with hardcoded ambassador data and basic filters.

Deliverables

  • Next.js project scaffold with cobe globe component.
  • Placeholder JSON data for 10 ambassadors across 5 continents.
  • Continent and country filter dropdowns.
  • Mobile responsive globe with drawer for filters.

Exit criteria

  • Globe renders with markers, pauses on hover, and filters work on a Vercel preview.
Phase 2

Phase 2 — Database & Auth

Add PostgreSQL, Prisma, and multi‑tenant auth for organizations.

Deliverables

  • Database schema for Organization, Ambassador, and Event (Prisma migration).
  • NextAuth with GitHub OAuth and credentials provider.
  • Admin middleware to protect /admin routes.
  • Seed script for demo organizations.

Exit criteria

  • Admin can log in and see an empty ambassador list; database is hosted on Vercel.
Phase 3

Phase 3 — Admin Dashboard + Dynamic Globe

Connect globe to real data and build admin CRUD for ambassadors.

Deliverables

  • Admin page to add/edit/delete ambassadors with form validation.
  • API routes to fetch ambassador data per organization.
  • Globe dynamically fetches and renders ambassador markers.
  • Profile popover on globe click with full ambassador details.

Exit criteria

  • Admin can add an ambassador, see it on the globe instantly, and edit it.
Phase 4

Phase 4 — Events & Customization

Add events globe and per‑organization theming.

Deliverables

  • Events page with separate globe, event list, and filter by continent.
  • Admin CRUD for events.
  • Custom subdomain routing (e.g., `org.codexglobe.com` points to their globe).
  • Basic white‑label options: logo, primary color.

Exit criteria

  • Organization can have its own events globe and branded subdomain.
Phase 5

Phase 5 — Monetization & Launch

Integrate Stripe billing, landing page, and production deployment.

Deliverables

  • Stripe metered pricing per ambassador count, with 10‑ambassador free tier.
  • Landing page with pricing, documentation, and sign‑up flow.
  • Automated user onboarding (create org, choose subdomain, pay).
  • Production Vercel deployment with custom domain and analytics.

Exit criteria

  • External user can sign up, pay, and see their own globe with ambassadors.

Build first

Build first, skip first, and watchouts

First things to build

  • Next.js App Router project with TypeScript, Tailwind, and shadcn/ui preset.
  • cobe globe component accepting a markers array and click handler.
  • Prisma schema for Organization and Ambassador, and a PostgreSQL connection.
  • NextAuth setup with GitHub provider and basic admin page behind auth.
  • Placeholder seed data to validate database and globe integration.
  • Vercel deployment pipeline with environment variables for database URL and auth secrets.

Not to build yet

  • Custom 3D rendering engine (rely on cobe; only extend if library is insufficient).
  • Native mobile apps (mobile‑web responsive is sufficient for MVP).
  • Advanced analytics dashboards with complex aggregates (start with Vercel Analytics).
  • Community features like forums, comments, or messaging within ambassador profiles.
  • Integration with CRM or HR systems (YAGNI until enterprise demand is proven).
  • AI‑powered ambassador matching or recommendation engine.
  • Multi‑language i18n support (defer until international customer base exists).

Risks / blockers

  • Market size unvalidated; Codex may be the only organization needing such a tool.
  • Performance issues with cobe on low‑end devices or with many markers (scalability unknown).
  • Dependency risk: cobe is a single‑developer library; API changes or abandonment could break the product.
  • Monetization friction: community managers may have no budget for a visualization tool.
  • Team bandwidth: a single developer can’t simultaneously build, market, and support with reliability.
  • Multi‑tenant data isolation must be perfect from day one; a privacy leak could be catastrophic.

Builder prompts

Derived builder prompts

Master

Master context prompt

Expand prompt
You are building a fresh implementation inspired by the crafter-station/codex-globe repository.
Treat the repository as a reverse-engineering reference, not as the default destination codebase.
Infer the product, architecture, entities, and flows from the reference repository, then rebuild the core system intentionally from scratch.
Do not blindly clone the original repo. Do not default to patching or refactoring it in place.
Build in small phases and keep the first version focused and maintainable.
Product thesis: Provide organizations with a managed, customizable, and interactive globe to showcase their global ambassadors, partners, or chapters.
Commercial/product framing: Organizations with geographically distributed ambassador programs need a frictionless way to visualize and manage their network. A hosted, no-code globe with integrated profiles and analytics beats DIY WebGL.
Target user: Community managers and event organizers at technology companies with ambassador programs.
MVP scope:
- Interactive 3D globe displaying ambassador locations with auto-rotation and pause-on-hover.
- Ambassador profile cards on click (name, country, bio, social links, avatar).
- Continent and country filters with a toggle to grid view grouped by geography.
- Authentication for admins via email/password or GitHub OAuth.
- Admin panel to add, edit, or remove ambassadors (name, location, photo, links).
- Static events page showing upcoming events with a separate events globe.
- Custom subdomain for each organization (e.g., org.codexglobe.com).
- Vercel Analytics integration to track page views and interactions.
Stack assumptions:
- Next.js 16 (App Router) with React 19 and TypeScript as the full‑stack framework.
- cobe v2 for WebGL globe rendering, driven by latitude/longitude data stored in DB.
- Tailwind CSS v4 and shadcn/ui for styling, with flag-icons for country flags.
- PostgreSQL database hosted on Vercel Postgres or Neon, connected via Prisma ORM.
- NextAuth.js for authentication, supporting GitHub OAuth and credentials.
- Stripe integration for subscription billing, with metered pricing per ambassador.
- Vercel for deployment, analytics, and edge functions.
Key entities:
- Ambassador: id, name, latitude, longitude, country
- Organization: id, name, slug, subscription_tier, ambassador_count
- Event: id, title, description, date, latitude
Core pages / routes / flows:
- Public Globe Dashboard (/[orgSlug]): Main interactive globe page showing ambassadors of a specific organization.
- Events Globe (/[orgSlug]/events): Separate globe view filtering events with list/grid toggle.
- Admin Login & Dashboard (/admin): Auth gate; redirects to ambassador CRUD interface after login.
- Ambassador Management (/admin/ambassadors): Table listing ambassadors with add/edit/delete actions using shadcn/ui forms.
- Landing Page (/): Marketing page for the hosted platform, pricing, and sign‑up.
Backend services / modules:
- Ambassador Service: CRUD operations for ambassadors, geocoding lookup or manual lat/lng entry, validation.
- Auth Service: NextAuth‑based authentication, organization‑scoped access, session management.
- Subscription Service: Stripe integration, metered billing per ambassador, plan management webhooks.
- Analytics Service: Capture page views, click events on ambassadors, and funnel data for customer reporting.
Do not build yet:
- Custom 3D rendering engine (rely on cobe; only extend if library is insufficient).
- Native mobile apps (mobile‑web responsive is sufficient for MVP).
- Advanced analytics dashboards with complex aggregates (start with Vercel Analytics).
- Community features like forums, comments, or messaging within ambassador profiles.
- Integration with CRM or HR systems (YAGNI until enterprise demand is proven).
- AI‑powered ambassador matching or recommendation engine.
- Multi‑language i18n support (defer until international customer base exists).
Major risks / blockers:
- Market size unvalidated; Codex may be the only organization needing such a tool.
- Performance issues with cobe on low‑end devices or with many markers (scalability unknown).
- Dependency risk: cobe is a single‑developer library; API changes or abandonment could break the product.
- Monetization friction: community managers may have no budget for a visualization tool.
- Team bandwidth: a single developer can’t simultaneously build, market, and support with reliability.
- Multi‑tenant data isolation must be perfect from day one; a privacy leak could be catastrophic.
Work in phases. After each phase, summarize what was built, what remains, and which assumptions from the reference repo you intentionally did or did not keep.

Phase 1

Phase 1 foundation prompt

Expand prompt
Phase 1 foundation

Objective: Reproduce existing globe with hardcoded ambassador data and basic filters.

Deliverables:
- Next.js project scaffold with cobe globe component.
- Placeholder JSON data for 10 ambassadors across 5 continents.
- Continent and country filter dropdowns.
- Mobile responsive globe with drawer for filters.
- Exit: Globe renders with markers, pauses on hover, and filters work on a Vercel preview.

Rules:
- Start by reverse engineering the product shape from the reference repo, then create a clean fresh project structure.
- Set up the minimum schema, services, routes, and project structure required for the MVP.
- Avoid polish work, avoid optional abstractions, and avoid copying implementation details you do not understand.

Start by reverse engineering the reference repository, then implement the fresh build in the smallest clean sequence.

Phase 2

Phase 2 core flow prompt

Expand prompt
Phase 2 core flow

Objective: Add PostgreSQL, Prisma, and multi‑tenant auth for organizations.

Deliverables:
- Database schema for Organization, Ambassador, and Event (Prisma migration).
- NextAuth with GitHub OAuth and credentials provider.
- Admin middleware to protect /admin routes.
- Seed script for demo organizations.
- Exit: Admin can log in and see an empty ambassador list; database is hosted on Vercel.

Rules:
- Implement the core pages, routes, and backend modules needed for the happy path in the fresh build.
- Use the reference repo for behavior and architecture cues, not as the code target.
- Preserve maintainability and add only the minimum comments needed.

Start by reverse engineering the reference repository, then implement the fresh build in the smallest clean sequence.

Phase 3

Phase 3 polish/refactor prompt

Expand prompt
Phase 3 polish and refactor

Objective: Connect globe to real data and build admin CRUD for ambassadors.

Deliverables:
- Admin page to add/edit/delete ambassadors with form validation.
- API routes to fetch ambassador data per organization.
- Globe dynamically fetches and renders ambassador markers.
- Profile popover on globe click with full ambassador details.
- Exit: Admin can add an ambassador, see it on the globe instantly, and edit it.

Rules:
- Refine the fresh implementation without introducing a large refactor.
- Improve validation, edge cases, and developer ergonomics where the core flow already exists.
- Prefer targeted cleanup over architecture churn or feature creep.

Start by reverse engineering the reference repository, then implement the fresh build in the smallest clean sequence.

Deploy

Deploy/finalization prompt

Expand prompt
Deploy and finalization

Objective: Prepare the implementation for release, verification, and handoff.

Deliverables:
- Verify the main flows work.
- Check configuration, environment assumptions, and release blockers.
- Summarize remaining risks and suggested follow-up work.

Rules:
- Do not add speculative infrastructure.
- Focus on practical release readiness, tests, and explicit known gaps versus the reference repo.

Start by reverse engineering the reference repository, then implement the fresh build in the smallest clean sequence.

Bugfix

Bugfix/refinement prompt

Expand prompt
Bugfix and refinement

Objective: Fix the specific bug or implementation gap in the fresh build while preserving the established architecture.

Deliverables:
- Reproduce the issue in the rebuilt implementation.
- Patch the smallest reliable fix.
- Explain what caused it, how to verify the fix, and whether the reference repo suggests an architecture guardrail you missed.

Rules:
- Inspect the fresh implementation before editing.
- Do not rewrite working systems just to fix a localized issue.

Start by reverse engineering the reference repository, then implement the fresh build in the smallest clean sequence.
    Build Pack · crafter-station/codex-globe