Features

The @frame/astro application is the main documentation portal for the monorepo, combining ultra-fast static site generation with on-demand interactive components (Islands Architecture).

Extensions and plugins

We use Starlight as the foundation, enhanced with a rich plugin ecosystem that improves both user and developer experience:

• LLM support: Structured content exposure via starlight-llms-txt for easy consumption by AI agents.
• Navigation: Powered by @inox-tools/star-warp.
• Logical diagramming: astro-mermaid for architecture diagrams at build time.
• Interactive visualization: Image zoom via starlight-image-zoom.

Dynamic components (islands)

Although most content is static by default, we add interactivity with React 19 and typed TypeScript components.

• @frame/core is used to keep operational consistency.
• Icons are handled with a combination of astro-icon and lucide-react.

Styles and design system

apps/astro uses Tailwind CSS v4.

• Styles are processed with PostCSS (cssnano, autoprefixer).
• Layout and utilities: Tailwind classes (grid, flex, gap-*, etc.).

Testing

To validate custom reactive utilities and logic functions, we use a Vitest-based setup.

Test level	Scope and tools	Command
Unit	Structural tests with vitest in a Node/Jsdom environment.	pnpm test

All unit tests (*.test.ts or *.test.tsx) live in the same folder as the reactive module or component under test.