Introduction

An opinionated, Vite-based React framework for building fast content sites.

Sitex is an opinionated React framework for content sites. Pages are MDX documents with typed frontmatter. Structure, chrome, and design live in TSX layouts and components. Every page renders to static HTML at build time; components opt into browser JavaScript with client:* directives.

The framework handles routing, asset loading, island scripts, head defaults, sitemap, robots.txt, and favicon. Everything else is plain React.

The Model

  1. src/pages/**/*.mdx — routable content documents with typed frontmatter.
  2. src/layouts/**/*.tsx — the full document around a page, selected by the layout field.
  3. src/components/**/*.tsx — blocks, UI primitives, and islands.

The split is strict on purpose: because every route is a content document flowing through the same pipeline, metadata is always complete and pages stay simple enough that anyone — or any agent — can add one without touching React.

Start with Installation.