markstream-nuxt
Integrate markstream-vue into Nuxt 3 or 4 with SSR-safe client boundaries, renderer modes, explicit CSS, and browser-only optional peers.
- License 许可
- MIT
- 最近更新
- 2026-11-09
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- markstream-nuxt
- risk
- critical
- tags
- [ "nuxt", "vue", "ssr", "markdown", "streaming" ]
- tools
- [ "claude", "cursor", "gemini", "codex" ]
- author
- Simon-He95
- source
- https://github.com/Simon-He95/markstream-vue/tree/main/.agents/skills/markstream-nuxt
- license
- MIT
- category
- frontend
- date_added
- 2026-07-21
- description
- Integrate markstream-vue into Nuxt 3 or 4 with SSR-safe client boundaries, renderer modes, explicit CSS, and browser-only optional peers.
- source_repo
- Simon-He95/markstream-vue
- source_type
- official
- license_source
- https://github.com/Simon-He95/markstream-vue/blob/main/license
03 SKILL.md 正文
Markstream Nuxt
Overview
Integrate markstream-vue into Nuxt while keeping hydration, browser-only peers, workers, and streaming behavior on the correct side of SSR boundaries.
When to Use
Use for Nuxt 3 or 4 pages, components, or plugins. Use markstream-vue for non-Nuxt Vue applications and markstream-install when the framework is not yet known.
Workflow
Before changing dependencies or source files, inspect the existing package manager and project conventions, preview the intended edits, and obtain explicit user approval.
- Confirm Nuxt 3 or 4 and install only requested peers.
- Put browser-only peers behind
<ClientOnly>,.clientplugins, dynamic imports, or guarded initialization. - Import
markstream-vue/index.cssexplicitly from a client-safe shell or plugin. - Start with
content:mode="chat"for AI streams,docsfor rich documents, andminimalfor lightweight non-chat surfaces. - Keep smooth streaming in
automode for SSR; do not forcetrueon first-screen server content. - When a chat row completes, keep its mode stable, set
final, disable pacing/cursor, and enable fade only if desired. - Keep HTML safe and Mermaid strict. Put optional code, diagram, and worker runtimes behind client boundaries.
- Validate build/typecheck, hydration, and one incremental client update.
Example
<script setup lang="ts">
import MarkdownRender from 'markstream-vue'
import 'markstream-vue/index.css'
defineProps<{ markdown: string; done: boolean }>()
</script>
<template>
<MarkdownRender
mode="chat"
:content="markdown"
:final="done"
:fade="done"
:typewriter="!done"
:smooth-streaming="done ? false : 'auto'"
html-policy="safe"
/>
</template>
Limitations
- Browser-only peers cannot run during SSR.
- Hydration depends on correct host plugin/component boundaries.
- This skill does not configure deployment adapters.
Security & Safety Notes
Do not expose trusted HTML or loose Mermaid settings to untrusted model output. Review dependency and runtime-boundary changes.
04 同仓库更多 Skills
dei-assessment
Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.
dei-action-plan
Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.
culture-fit-assessment
Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.
cowork-to-code-bridge
Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.
counter-offer-response
Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.
continuous-feedback-system
Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.