Design & Implementation

This section is written for developers of static site generators, and for users who want to understand what happens inside the framework. The content leans toward design tradeoffs and implementation details, references source paths, and explains why things are done this way. If you only want to get a site running, go to the Guide.

• Why Another One: positioning, a comparison with Astro / VuePress / VitePress, measured performance, and the costs
• Architecture: two-phase build, page shell, mount contract, base detection, and the render cache
• Build Pipeline: the markdown-it pipeline, link resolution, archive aggregation, and incremental caching
• Islands Runtime: placeholder markers, client-side hydration, and the built-in island implementations