AstroLink
AstroLink is a paid expert network for aerospace and space — live 1:1 video sessions with verified operators, astronauts, and industry specialists (GLG/Minnect-style, vertical-specific).
Buyers book sessions, receive AI-generated pre-call briefs, join private Daily rooms, and get post-session recaps. Experts set rates; the platform handles payments, compliance hooks, and bilingual session access.
Stack: Next.js 16 (App Router) · Supabase · Stripe · Daily · Gemini (@google/genai)
Engineering status: docs/d1-implementation-plan.md
Gemini XPRIZE
AstroLink is an entrant in Build with Gemini XPRIZE ($2M prize pool, deadline Aug 17, 2026).
| |
|---|
| Category | Professional Services Access — connecting everyday people with the expert guidance they need |
| Problem | High-stakes aerospace knowledge is locked behind personal networks, opaque consulting firms, and conferences most buyers cannot access |
| Product | A marketplace where anyone can discover, book, and follow a live session with a verified expert — with AI running match, brief, synthesis, translation, and compliance triage |
Why this category
AstroLink is not a generic video app or course platform. It sells access to named experts — flight controllers, program managers, astronauts — with escrow, audit trails, and session context built for regulated-adjacent domains.
AI-native operations (production agents)
Gemini (and OpenAI fallback via src/lib/llm.ts) runs key decisions in the live product:
| Agent | Role |
|---|
| APX-01 Match | Default /booking path: the configured LLM picks a listed expert from goals (browse is optional) |
| APX-10 Path Assessment | Free readiness report; Gemini matches a listed expert when the model succeeds |
| APX-02 Briefing | Dual pre-session briefs for mentee + expert (briefing_json v2 bundle) |
| APX-12 Settlement | After hang-up, decides completed / no-show / hold and payout eligibility |
| APX-03 Session | Post-call summary only when a stored transcript exists |
| APX-06 Translation | Live captions and localized recap (aerospace glossary) |
| APX-09 Reviews | Screens consented quotes; auto-publishes only when policy-clear |
Structured decision logs for judges: T8 in D1 plan (export from audit_log).
Competition links
Supabase setup
-
Copy env template and fill keys from the Supabase dashboard (publishable/anon + service role for server agents):
cp .env.example .env.local
-
Migrations live in supabase/migrations/ and are applied to project vwoizjesyyygmokfqpyy:
20260531140000_initial_schema.sql — core tables + RLS (public mentor directory)20260531140100_seed_d1_dev.sql — dev seed (Chris Sembroski, [email protected] user)
-
Regenerate DB types after schema changes (requires Supabase CLI):
supabase link --project-ref vwoizjesyyygmokfqpyy
supabase gen types typescript --linked -o src/lib/database.types.ts
-
Demo auth (local and E2E): with ENABLE_DEMO_AUTH=true, use seed emails in src/lib/auth-presets.ts — mentee [email protected], mentor Chris [email protected], or demo mentor Carlos [email protected] (dual-device video: see docs/how-to/demo-dual-device-video.md). Public Google sign-in is Clerk at /sign-in and /sign-up when the Clerk keys in .env.example are set. Demo presets stay on /auth.
D1 local booking flow
- Set in
.env.local: Supabase keys, GEMINI_API_KEY (LLM_PROVIDER=gemini), STRIPE_SECRET_KEY, NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, STRIPE_WEBHOOK_SECRET, DAILY_API_KEY, and SKIP_STRIPE_PAYMENTS=true for local booking without Stripe.
- Run
npm run dev, sign in as Carlos ([email protected] on /auth with demo auth enabled).
- Landing hero search ("Talk to flight controllers...") jumps to
/experts?q= (category filters, name/role/expertise search, card grid, inline preview — desktop modal or mobile sheet); the landing page also shows a fixed five-expert directory grid (Eiman, Chris, Priya, Jenni, Andrew). Click a name for the profile page (/experts/[slug]) or use Book session on a card for the fast path.
- Profile or card → Book →
/booking?mentor=chris-sembroski still books that expert. Bare /booking (no mentor) is the Gemini match path: goals → APX-01 → listed expert. Pay with Stripe test card 4242….
- After authorize, either:
- Forward webhooks:
stripe listen --forward-to localhost:3000/api/webhooks/stripe, or
- Dev fulfill:
POST /api/book/fulfill with { "bookingId": "<uuid>" } (development only).
- Mentee dashboard shows APX-02 briefing; Join session opens
/session/[bookingId] with a server-minted Daily token (private room). Buyers confirm captions/recap language before Daily mounts.
Repository layout
| Path | Purpose |
|---|
src/app/ | Routes and API (/early-access, /join, /experts, /booking, /talk-with-chris, …) |
src/components/ | Feature UI (early-access, experts, booking, session, chris-campaign) |
src/lib/chris-campaign/ | Chris booking campaign: dual pricing, slots, dates, referrers, route allowlists |
src/lib/waitlist/ | Waitlist signup, routing, metrics, analytics |
src/lib/transcript-translation/ | Live captions and post-call translation |
docs/ | Tutorials, how-tos, reference (index) |
Documentation
Index: docs/README.md
External SDK maintenance
SDK drift for OpenAI, Stripe, Supabase, and Daily is handled by the published CLI simon-maintain (source: simon-maintain) — not a vendored copy in this repo.
npm run maintain:check -- openai # or: stripe | supabase | daily | all
npm run maintain:status
npm run maintain -- migrate openai --dry-run
State is written under .simon/ (gitignored). Legacy .astro-maintain/ is also ignored.
Tests
npm test # Vitest unit/contract tests
npm run test:e2e # Playwright D1 golden path (requires .env.local + Supabase seed)
Vitest covers D1 contract logic: booking pricing, /api/book request schema, Daily webhook parsing, LLM rate limits (including caption scope), dev payment skip helpers, session waitlist guard (getSession), Stripe booking test-mode production guard, booking-agent mentor pool validation, D3 translate-segment / segment-cache / translation-queue / caption-direction / guess-supported-locale / POST /api/me/preferred-locale paths, transcript APIs, public expert helpers (expert-book-href, expert-bio), and Chris campaign helpers (chris-pricing, chris-campaign-dates, slots, booking validation).
E2E (Playwright)
Automates the skip-Stripe D1 golden path, D3 localized recap, D3 live-caption stub, and public experts directory: E2E session bootstrap → book Chris → APX-02 briefing → session room (mentee confirms caption language via e2e/helpers/caption-language.ts before Daily mounts); pt-BR mentee recap after simulate_meeting_ended; mentee caption rail with stubbed segment translation; /experts filters, preview panel, and profile deep links.
Prerequisites: .env.local with Supabase keys, ENCRYPTION_KEY, and seed data applied (20260531140100_seed_d1_dev.sql, plus 20260607120000_session_translations.sql for D3 Phase 2). Playwright sets APP_MODE=full, ENABLE_DEMO_AUTH=true, SKIP_STRIPE_PAYMENTS=true, E2E_STUB_LLM=true, and DAILY_TRANSCRIPTION_ENABLED=false on the dev server automatically (so post-session synthesis runs without Daily transcription).
Playwright starts its own Next.js dev server on 127.0.0.1:3000 — stop any other process on that port before running E2E.
npm run test:e2e # headless
npm run test:e2e:ui # interactive UI mode
E2E bookings are tagged with spec-specific goals prefixes (E2E:golden-path, E2E:localized-recap, E2E:live-captions, E2E:experts-directory, etc.) and cleaned up before/after each spec. See docs/d3-transcript-translation-roadmap.md for D3 phases. Real Stripe checkout E2E is deferred to the real-Stripe feature branch.
Getting Started
cp .env.example .env.local # fill Supabase, Stripe, Daily, GEMINI_API_KEY (OpenAI optional fallback)
npm ci
npm run dev # http://localhost:3000
Production: APP_MODE=full — directory, booking, and /talk-with-chris are open. APP_MODE=waitlist is a kill-switch only. See AGENTS.md.
Deploy: Vercel (production URL: astro-link.space). See docs/how-to/stripe-production-cutover.md for payment cutover.
