Supafone Labs · Documentation

🧭 Frontend Routing#

This page is for the Labs frontend docs and builder navigation. It explains how the static frontend should route users through the developer experience.

Primary Routes#

RoutePurpose
/Product overview and entry points
/docs/Prerendered, crawler-readable documentation index
/docs.htmlCompatibility alias for /docs/
/builder.htmlAgent Factory and provider-agnostic builder
/console.htmlAccount, usage, logs, keys
/tester.htmlOracle/TTS/STT playground
/get-key.htmlLabs Cloud key signup
/pricing.htmlPricing and credits

GitBook docs should mirror those routes with pages for quickstart, Agent Factory, provider framework, BYOK, voices, logs, MCP, and E2E testing.

Builder First Screen#

The first screen should answer one question: "How do I create a working agent with one key?"

Required above-the-fold controls:

  1. Supafone API key.
  2. Inbound/outbound selector.
  3. Agent name and prompt.
  4. Voice provider and voice preview.
  5. Labs on/off with managed/BYOK mode.
  6. Number strategy.
  7. Create agent.
  8. Export TypeScript/Python.
  9. Log stream.

Advanced hosted-delivery credentials should be split into three drawers:

DrawerExamples
Agent/provider stackFourteen audited runtime adapters
TelephonyTwilio, Telnyx, Plivo, SignalWire, SIP/custom trunks
TTSCartesia, ElevenLabs, Inworld, Deepgram, custom TTS

Export Panel#

The builder should export:

The exported config should be the same payload the builder sends. That makes the UI a code generator instead of a demo.

Logs Panel#

The builder should connect to:

text
GET /v1/logs
GET /v1/logs/stream

Show endpoint, provider, model, voice, duration, billed seconds, and detail. Provide a raw JSON drawer per row.

Voice Preview Panel#

Use:

text
GET  /v1/voices
POST /v1/tts

The preview should be available before provisioning the final agent. If the selected engine is not configured or the key has no balance, show the API error directly and keep the rest of the builder usable.

View raw Markdown