tdsk-website

Documents the React marketing site and MDX documentation portal architecture.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/threadedstack/threadedstack --skill tdsk-website-threadedstack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tdsk-website
Source: https://github.com/threadedstack/threadedstack/tree/main/.claude/skills/tdsk-website
Command: npx skills add https://github.com/threadedstack/threadedstack --skill tdsk-website-threadedstack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working on the marketing site and docs portal need to understand the Vite/React architecture, MDX docs loading pipeline, and routing conventions before making changes, and this Skill provides that knowledge base. ## Core Features & Use Cases - Architecture Reference: Documents the Vite 5 + React Router v7 + MUI 6 stack, directory structure, and lazy-loaded routing across MarketingLayout and DocsLayout. - Docs System Guide: Explains the MDX loading flow via import.meta.glob, _meta.json navigation format, Shiki code highlighting, and docs asset handling. - Use Case: When adding a new documentation page, consult this Skill to learn the _meta.json format, slug-to-MDX mapping, and how remarkDocsLinks rewrites .md links and image paths. ## Quick Start Ask how to add a new docs page or marketing page to the website and follow the documented conventions.

Frequently Asked Questions about tdsk-website

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new page to an MDX documentation site?▼

Add a .md or .mdx file to the root /docs directory and register it in the section's _meta.json with a slug and optional label. The docsLoader maps URL slugs to lazy MDX imports discovered via import.meta.glob at build time.

How does the docs navigation sidebar get built from _meta.json?▼

Each docs section contains a _meta.json file with a label, order, and pages array of slugs or slug/label objects. The buildNavigation function in docsLoader.ts reads these files to construct the sidebar structure.

How are images in MDX docs served in dev and production?▼

In dev mode, an Express middleware serves /docs-assets/* from the docs root. For production builds, images are copied to dist/docs-assets/, and the remarkDocsLinks plugin rewrites relative image paths accordingly.

What port does the Vite dev server use for this website?▼

The Vite 5 dev server runs on port 5884, configured in website.config.ts. Start it with pnpm start from the website package.

Why are my .md links broken in the rendered docs pages?▼

Relative .md links must be rewritten to /docs/slug routes by the remarkDocsLinks plugin. Verify the plugin is registered in the Vite MDX configuration and that your links use relative paths to other docs files.