boos
e0a5f57793
Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as a monorepo subdirectory under desktop/. Source only — node_modules, dist, Cargo target and the upstream .git history are excluded. desktop/ keeps its own independent Cargo workspace (desktop/src-tauri with crates/*); it is not part of the backend boosapi crate, so a `cargo check` at the metapi root still compiles only the backend. Build the desktop app from desktop/src-tauri per desktop/README.md. Note: app icons are still placeholder assets pending the final BoosAPI logo. The updater signing keys live outside the repo and are not included.
7.5 KiB
7.5 KiB
layout, description, hero, features
| layout | description | hero | features | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| home | Streaming-friendly Markdown renderer for Vue, React, Angular, and Nuxt with guided docs for installation, VitePress, AI chat, overrides, and migration. |
|
|
A streaming-friendly Markdown renderer with progressive Mermaid support, streaming diff code blocks, and high-performance handling of large documents.
Pick The Shortest Path
| If you are trying to... | Start here | Then go to |
|---|---|---|
| get the first render on screen | Installation | Quick Start |
| integrate it into a docs site or VitePress theme | Docs Site & VitePress | Custom Tags & Advanced Components |
| wire streaming or SSE output | AI Chat & Streaming | Performance |
| debug a broken integration but you do not know why | Troubleshooting by Symptom | Troubleshooting |
| replace one built-in node renderer | Override Built-in Components | Renderer & Node Components |
add trusted tags such as thinking |
Custom Tags & Advanced Components | API Reference |
| work at the parser / AST layer | API Reference | Parser API |
| migrate or use AI to speed up adoption | AI / Skills workflows | react-markdown migration |
Choose Your Role
I am new to markstream
- Start with Guide Home if you want the task-oriented map.
- Use Installation if you already know the framework and just need the right peer set.
- Use Quick Start if you want the smallest Vue 3 example first.
I am integrating it into an existing app
- Use Usage & Streaming to choose between
contentandnodes. - Use Docs Site & VitePress if the app is really a docs site, content hub, or VitePress theme.
- Use AI Chat & Streaming if the UI updates constantly and you want a single guided path.
- Use Troubleshooting by Symptom if you do not yet know which subsystem is broken.
- Use Troubleshooting if the install works but CSS, peers, or SSR look wrong.
- Use Nuxt SSR when browser-only peers must stay behind client boundaries.
I am customizing rendering
- Use Renderer & Node Components when you already know the node/component you need.
- Use Override Built-in Components to replace
image,code_block,mermaid,link, and other built-ins safely. - Use API Reference and Parser API for parser hooks, AST transforms, and scoping helpers.
I want help from AI tools
- Use AI / Skills workflows for packaged skills, copyable prompts, and rollout order.
- Use AI / LLM context if your assistant can read repository context files.
Choose Your Framework
::: tip Framework Support All framework packages share the same core rendering model, but the entry pages differ by runtime and migration path. :::
| Framework | Best first page | Use when | Demo |
|---|---|---|---|
Vue 3 (markstream-vue) |
Guide Home | You want the main, most fully documented integration path | Live demo |
| VitePress docs site | Docs Site & VitePress | You are embedding renderer output into documentation pages or a content-driven site | Live demo |
| Nuxt | Nuxt SSR | You need client-only guards, SSR notes, or worker setup | Live demo |
Vue 2 (markstream-vue2) |
Vue 2 Quick Start | You are on Vue 2.6 / 2.7 and need the compatible package | Live demo |
React (markstream-react) |
React Quick Start | You are adopting React directly or migrating from react-markdown |
Live demo |
Angular (markstream-angular) |
Angular Quick Start | You are using standalone Angular components | Live demo |
Common Destinations
- API Reference for parser helpers, scoping, and render-pipeline decisions
- Renderer & Node Components for exported renderer and node component reference
- Troubleshooting by Symptom for first-pass diagnosis before diving into subsystem docs
- Troubleshooting for CSS/reset order, peers, and common issues
- Features for a capability overview across streaming, Mermaid, Monaco, KaTeX, and more
- AI / LLM context and AI / LLM 上下文 for repository-aware assistants
How The Docs Are Organized
Start Hereis task-oriented: install, first render, streaming usage, and props.Customizationcovers renderer overrides, custom tags, parser hooks, styling, and troubleshooting.Feature Guidesis now collapsed by default and holds the deeper dives for code blocks, Mermaid, KaTeX, D2, Monaco, and related nodes.Frameworks & Migrationis for Vue 2, React, Angular, Nuxt, and AI-assisted adoption workflows once you already know your target path.