Skip to content

docs: rework Introduction and Getting Started - #1278

Merged
vishxrad merged 9 commits into
mainfrom
abhishek/docs-refinements
Sep 30, 2026
Merged

vishxrad merged 9 commits into
mainfrom
abhishek/docs-refinements

Conversation

@abhithesys

@abhithesys abhithesys commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Summary

New readers couldn't tell how OpenUI works from the Introduction, and Getting Started didn't walk through an integration. This reworks both pages.

Introduction (/docs)

  • Positions OpenUI as the open standard for Generative UI, with OpenUI Lang at its core and usable with any model, agent framework, or chat UI.
  • Replaces the static demo image with a live streaming demo (OpenUILangStreamDemo): OpenUI Lang streams in and renders with openuiLibrary, with a Preview / OpenUI Lang toggle and Replay. It starts when scrolled into view and respects prefers-reduced-motion.
  • Adds a How it works section with a new flow diagram (OpenUIFlowDiagram, inline SVG, light/dark via theme tokens) showing both routes: through OpenUI Gateway (recommended) or calling models directly with Autofix. The steps are kept to one line each.
  • Replaces the stack cards with a What's in OpenUI list.
  • Removes How OpenUI works (architecture.mdx) since its content now lives in the Introduction. /docs/architecture redirects to /docs, and the nav entry and test are updated.
  • Hides the previous/next footer on this page.

Getting Started

  • Create a new app is now a single npx @openuidev/cli@latest create command, linking to the CLI reference for flags and deploy.
  • End-to-end integration is adapted from the Gateway Generative UI Quickstart: library → spec → call a model (tabs: OpenUI Gateway / OpenAI + Autofix) → render. It includes the flow diagram, the generate-api-key command, and a note on using other providers.
  • Next steps links to chat interfaces, the OpenUI Lang deep dives, and production docs.

Other

  • New hideFooter frontmatter option (source.config.ts, docs-page.tsx) to hide the previous/next page links.

This branch also carries an earlier commit, "make navbar back button go back in history when possible", plus a merge from main.

Test plan

  • lib/docs-navigation.test.ts passes
  • ESLint passes on the new and changed components
  • Checked /docs and /docs/getting-started in the browser: demo streaming, toggle and Replay; diagram in light and dark; phone-width layout; Getting Started tabs

🤖 Generated with Claude Code

abhithesys and others added 3 commits September 24, 2026 16:28
Falls back to the home page when there is no same-site entry to return to.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Introduction:
- Position OpenUI as the open standard for Generative UI, with OpenUI Lang at its core
- Replace the static demo image with a live OpenUI Lang streaming demo (Preview / OpenUI Lang toggle)
- Add a "How it works" flow diagram showing Gateway (recommended) and direct calls with Autofix
- Replace the stack cards with a "What's in OpenUI" list
- Fold in "How OpenUI works" and remove that page (redirect /docs/architecture to /docs)

Getting Started:
- Single `openui create` command for new apps
- End-to-end integration steps adapted from the Gateway quickstart, with Gateway and OpenAI + Autofix tabs
- Next steps links

Also adds a `hideFooter` frontmatter option to hide the previous/next page links.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
openui-docs Ready Ready Preview Sep 30, 2026 3:01pm UTC

Request Review

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
abhithesys and others added 2 commits September 30, 2026 18:54
…name

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ix example

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds an optimized looping video (1600px, 30fps, no audio, 2 MB) with a poster
below the first paragraph, and removes the now-unused stream demo component.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vishxrad
vishxrad merged commit 077b7bd into main Sep 30, 2026
4 checks passed
@vishxrad
vishxrad deleted the abhishek/docs-refinements branch September 30, 2026 17:44

This branch was successfully deployed

1 active deployment
Preview — ab577d5b Deployed Sep 30, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants