OutworxOutworx Docs
Changelog

What’s new in Outworx Docs.

Every user-visible change, newest first. We ship often.

  1. v1.0FeatureAIPlatform

    Launch — MCP server, guides hub, dynamic OG

    The 1.0 launch push: every project gets a Model Context Protocol server so AI assistants can operate your API; new /guides content hub with seeded long-form tutorials; dynamic OG image generation for better link previews everywhere.

    • Per-project MCP server at /api/mcp/<slug> with 12 tools (list/search endpoints, generate TypeScript types, ask docs, execute live calls, and more)
    • Schema inference — live calls via execute_endpoint sample response bodies and merge into a stored schema, so generated types stay accurate even when the OpenAPI spec is incomplete
    • Dashboard MCP tab — one-click token + Claude Desktop / Cursor / Cline / curl connection snippets, per-tool permission toggles, recent activity feed
    • Guides content hub at /guides with OpenAPI-to-TypeScript, Claude Desktop MCP setup, GitHub Actions auto-sync, and ReadMe/Mintlify migration tutorials
    • Dynamic OG images via /api/og — every marketing page, guide, and comparison gets a branded, on-brand preview
    • Tightened chat token accounting — visitors are billed per-turn (their message + response) instead of the full system prompt, so daily caps now correlate with real visitor intent
    • Sliding conversation window — chat keeps the last 8 messages instead of the entire session, bounding our OpenAPI bill as threads get long
  2. ImprovementPlatform

    Analytics, SEO, and mobile polish

    PostHog analytics wired at the conversion points that matter, structured-data + sitemap cleanups so Google indexes what we actually want, and a pass over the MCP tab for mobile screens.

    • PostHog client-side integration with custom events at chat, subscription, and project lifecycle moments
    • FAQPage / SoftwareApplication / BreadcrumbList / Organization JSON-LD across marketing
    • Sitemap emits subdomain/custom-domain canonicals for hosted docs (no more duplicate-content flags in Search Console)
    • Hero badge, MCP tab, and activity feed laid out cleanly on mobile
    • llms.txt published so Claude, ChatGPT, and Perplexity see accurate context about the product
  3. FixAI

    AI chat quality + billing correctness

    A round of chat-drawer fixes that landed right before launch: accurate endpoint pills in responses, honest daily-token counters, and a hard-to-spot DB constraint bug that was silently dropping every chat usage row.

    • ai_usage CHECK constraint now allows action='chat' — previously every chat usage insert was silently rejected, leaving the daily-tokens counter at 0 forever
    • Fallback completion-token estimation when OpenAI omits the usage chunk
    • Assistant messages now pill-ify `[endpointId]` citations correctly even when the model wraps them in backticks
    • Copy-to-clipboard on every code block in the chat drawer + the Chat Activity admin view
  4. PlatformFeature

    Sentry, welcome email, and onboarding

    Pre-launch infrastructure so new users have a first-run experience that doesn't feel empty and errors actually get reported.

    • Sentry error monitoring wired for server, edge, and browser runtimes
    • Welcome email on first dashboard load (Resend) with a 3-step onboarding checklist, Outlook + dark-mode-safe HTML, and atomic once-only delivery
    • Dashboard empty state with a clear 'upload your first spec' CTA
    • Global crash page that reports to Sentry
  5. FeatureAI

    AI chat drawer on public docs

    The big visitor-facing AI feature. A floating Ask AI button on every Pro/Business docs site opens a chat drawer trained on the project's spec.

    • Streaming chat completions with per-visitor session persistence via localStorage
    • pgvector-backed RAG retrieval for specs with 50+ endpoints, with lazy embedding on first query
    • Chat Activity dashboard tab so project owners see what visitors actually ask
    • Daily token caps per plan (Free 0 / Pro 25k / Business 200k) + hourly rate limits per visitor
    • Endpoint citations in answers render as clickable pills that jump the docs to the referenced endpoint
  6. FeatureImprovement

    Subscription flows reworked

    Upgrade and downgrade UX rebuilt around explicit preview-and-confirm dialogs, plus scheduled downgrades via Stripe Subscription Schedules so customers never lose paid access mid-cycle.

    • Preview dialog shows exactly what will be charged today, the prorated breakdown, and the next recurring amount
    • Downgrades are scheduled to the end of the current period (not immediate) via Stripe Subscription Schedules
    • Billing cycle switches (monthly ↔ yearly) handled in-place without creating new subscriptions
    • Pricing restructured — Pro at $9/mo, Business at $19/mo, 10-month discount on yearly
  7. FeaturePlatform

    Multi-version + custom domain + auto-sync

    Project-level features that make hosted docs production-ready for teams.

    • Multiple active versions per project with a dropdown switcher on public docs
    • Custom domains with auto-provisioned SSL (Business plan) — one CNAME, done
    • Auto-sync from a spec URL on an hourly / daily / weekly schedule
    • Deep-link to any endpoint by URL hash; Overview page lists every endpoint clickably
  8. AI

    AI search, descriptions, code examples

    First-pass AI features for documentation quality, before the full chat drawer landed.

    • Natural-language search across the spec (Free tier gets 5/month; paid gets unlimited)
    • Auto-generated endpoint descriptions for sparse specs
    • AI code examples in any language or framework — NestJS, Django, Rails, FastAPI, Rust, and more