nitrocloudofficial/nitrostack

Improve focus visibility and semantics on the bundled MCP docs page Summary: The server-generated MCP documentation HTML (served by core over HTTP) needs keyboard focus styles and sensible headings—not the CLI widget templates. Where to change (required): typescript/packages/core/src/core/transports/streamable-http.ts — inside generateDocumentationPage, add rules to the inline <style> block and adjust markup only if needed for semantics. Explicitly out of scope for this issue: Styling scaffolded apps under typescript/packages/cli/templates/** (e.g. typescript-oauth, typescript-starter widget globals.css). Those are separate apps; improving them is welcome as a different issue or PR without closing this one. Background: Footer links (<a href="https://nitrostack.ai">) and collapsible tool schemas (<details><summary>) rely on browser default focus rings, which are inconsistent. Section titles use leading emoji (<h2>🛠️ Available Tools</h2>); ensure heading levels remain a logical

Polish dark mode and motion on the bundled MCP documentation page Summary: Dark mode tweaks inner variables but the page body keeps a bright gradient; animations ignore reduced motion. Where to change: typescript/packages/core/src/core/transports/streamable-http.ts — <style> inside generateDocumentationPage. Acceptance criteria: body background respects prefers-color-scheme: dark (or equivalent) without killing light mode. @media (prefers-reduced-motion: reduce) disables non-essential transforms/transitions on .tool-card and similar. Suggested labels: visuals, accessibility, good first issue Source: docs/STARTER_ISSUES_REVIEW.md — edit in-repo first, then sync GitHub issues if needed.

Align Streamable HTTP docs page branding with NitroStack (CSS + assets) Summary: The bundled HTML docs page still says "NitroCloud" in CSS variables and image alt text. Where to change: typescript/packages/core/src/core/transports/streamable-http.ts — generateDocumentationPage inline CSS and logo alt. Acceptance criteria: Rename --nitrocloud-* to --nitrostack-* or --brand-*; update logo alt to NitroStack. Optional: align primary hex with CLI branding.ts. Suggested labels: visuals, good first issue Source: docs/STARTER_ISSUES_REVIEW.md — edit in-repo first, then sync GitHub issues if needed.

Refresh stale header comment in CLI branding module Summary: Top-of-file comment does not match NitroStack branding. Where to change: typescript/packages/cli/src/ui/branding.ts — header comment block only. Acceptance criteria: Comment reflects NitroStack (or neutral "NitroStack CLI") with no outdated org name. Suggested labels: chore, good first issue Source: docs/STARTER_ISSUES_REVIEW.md — edit in-repo first, then sync GitHub issues if needed.

Tests for ReadResource response shaping by content.type (text / binary / json) Summary: ReadResource builds MCP contents from a switch on content.type. Regressions (e.g. missing break) should be caught by tests. Where to change: typescript/packages/core/src/core/server.ts (handler); new or extended tests under typescript/packages/core/src/**/__tests__/ (follow existing layout). Acceptance criteria: Tests for text, binary, and json branches assert mimeType, text vs blob, and JSON stringification of data only for json. No fall-through to default for valid json payloads. Suggested labels: test, good first issue Source: docs/STARTER_ISSUES_REVIEW.md — edit in-repo first, then sync GitHub issues if needed.