A standalone Angular chat example using @openuidev/angular-lang, NG-ZORRO X, and OpenUI Cloud. Ask a question and receive streamed, model-generated charts, tables, checklists, forms, and follow-up suggestions.
NG-ZORRO X owns the conversation list, message bubbles, composer, auto-scroll, and send/stop controls. OpenUI renders each assistant bubble through its messageRender template. Angular signals manage conversation history and streaming state. This demonstrates the Angular runtime introduced in #1167, using published packages without a repository build.
- Node.js 22.22.3+, 24.15.0+, or 26.x, within those supported major versions (Angular compatibility). Node 24 LTS is recommended.
- pnpm, npm, or Bun as the package manager. The backend and development scripts run on Node.
- An OpenUI Cloud API key from the Thesys console.
The example pins OpenUI Angular and Lang Core to 0.3.0, NG-ZORRO Ant Design to 22.1.0, and NG-ZORRO X to 0.6.0-alpha.1. The NG-ZORRO X alpha is used for Angular 22 compatibility. Angular and its build tools resolve through the included lockfiles. The example is zoneless and does not need zone.js or @angular/platform-browser-dynamic.
cd examples/app-frameworks/angular
pnpm install --ignore-workspace
# or: npm ci
# or: bun installMint a THESYS_API_KEY into a gitignored .env.local in this directory, or create that file and configure the key there yourself:
pnpm generate:apiKey
# or: npm run generate:apiKey
# or: bun run generate:apiKeyKeep the key server-side and out of Git. You can optionally set OPENUI_MODEL to a supported provider/model identifier; the default is google/gemini-3.6-flash-free, matching the Vue and Svelte examples.
pnpm dev
# or: npm run dev
# or: bun run devOpen http://127.0.0.1:4200. The development command generates the Cloud library configuration, starts the loopback-only Cloud proxy on port 4300, and starts Angular with an /api proxy. Only the backend reads the key; browser requests contain conversation messages. The proxy calls https://api.thesys.dev/v1/embed/chat/completions.
For different ports, pass PORT and API_PORT to the development command:
PORT=4220 API_PORT=4320 pnpm devYou can instead set OPENUI_ENV_FILE to an existing server-side environment file. Shell environment variables take precedence over values loaded from files. These settings are for a local example; deployment needs an authenticated backend, request limits, and a production frontend host.
- Chart: “Show quarterly revenue as a labeled bar chart: Q1 120, Q2 180, Q3 150, Q4 240. End with two relevant follow-up suggestions.” The response should stream into a labeled chart. Click a suggestion to send its text as the next turn in the same conversation.
- Form: “Create a validated project estimate form with fields for project name, team size, and notes. Add a Submit button that sends the completed values to you.” An empty submission is blocked by native required-field validation. Fill in
Aurora-731,7, andPrioritize accessibility and charts, then submit. The next assistant response should use those values. - Conversation controls: stop an in-flight response, retry the last response, start another conversation, and switch back using the sidebar.
Like the Vue and Svelte examples, this uses Cloud Chat Completions with app-owned history. Conversation messages persist in this browser's local storage and the recent history is sent with each request. Existing local conversations stay available; this example does not import them into Cloud conversation storage. Form drafts and checklist selections are local component state and reset when their message is remounted or the page reloads. The model has no web search or external-action tools. Generated sample data is labeled illustrative.
NG-ZORRO X sender → Angular send() → /api/chat → OpenUI Cloud
↓
NG-ZORRO X assistant bubble ← OpenUI Renderer ← streamed OpenUI Lang
↓
follow-up / form action → the same Angular send() path
src/app/app.tsandapp.htmlconnectNxConversations,NxBubbleList, andNxSenderto Angular state. The assistant bubble'smessageRendertemplate contains<openui-renderer>.src/app/openui/schema.tsis the shared source of component names, ordered Zod props, and prompt options.library.tsbinds those definitions to Angular components.server/library.mjsuses the same schemas with the framework-independent Lang Core package to generate the managed Cloud configuration and validate final output.src/app/openui/components.tsimplements the small component library. Follow-ups calltriggerAction; forms serialize their title and edited, labeled values into the same action path.(action)becomes one ordinary user turn and one backend request.server/index.mjsvalidates the conversation envelope, streams a Cloud Chat Completion, and checks the final OpenUI program. Cloud owns prompt assembly and output correction; the proxy makes one Cloud request per user turn. Disconnects abort upstream work.server/transport.mjshandles Cloud SSE framing, Unicode, aborts, truncation, and provider errors without forwarding private diagnostic bodies.src/styles.csssupplies a shared CSS variable theme to the chat shell and rendered Angular descendants. Angular Lang has no ReactThemeProviderorAgentInterface; NG-ZORRO X supplies the native Angular shell.
pnpm generate regenerates generated/system-prompt.txt and the library schema. The prompt file contains the managed config block produced by generateSystemPrompt({ cloud: true, library: library.toSpec(), promptOptions }), using the exact custom Angular schemas. dev, build, test, and verify do this automatically. Keep generated files out of Git.
No credentials or live model calls are needed:
pnpm verify
# or: npm run verify
# or: bun run verify
pnpm format:checkVerification checks action serialization, request validation, provider streaming/error handling, and canned OpenUI parsing, then compiles the Angular application with strict template checks. The production frontend is written to dist/openui-angular/browser; the backend remains a separate Node process.
For a live check, exercise the chart, follow-up, form, stop/retry, and conversation controls above. A completed response should have no renderer errors in its optional “View OpenUI source” disclosure and the backend should report parser errors=0.
Add a Zod definition in schema.ts, implement the Angular component, and register it in library.ts. The generated prompt and parser schema will follow that same definition. Keep strings and arrays tolerant of partial streamed props. Use the Angular API reference for nested rendering, form state, validation, and tool providers.