Skip to content

XiSenao/docs-islands

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Docs Islands

Docs Islands logo


node compatibility build status Start new PR in StackBlitz Codeflow


English | 简体中文

⚡ Project Status: Actively developed - VitePress integration production ready.

Brings the performance benefits of Islands Architecture to documentation frameworks. Static content loads instantly while interactive components activate on-demand, enabling documentation sites to achieve both the speed of static websites and the interactivity of modern applications. Supports cross-framework UI usage, currently providing production-grade integration for VitePress.

Key Features

  • 🏝️ Exceptional Performance - Static content renders instantly while interactive components load on-demand. Documentation sites achieve both the speed of static websites and the interactivity of modern applications, delivering a seamless reading experience.

  • 🎯 Flexible Rendering Strategies - Fine-grained control over each component's rendering and hydration timing. Supports server-side rendering (ssr:only), eager loading (client:load), viewport-triggered loading (client:visible), and client-only rendering (client:only). Eliminates unnecessary JavaScript execution, ensuring interactions happen at precisely the right moment.

  • 🧩 Extensible Architecture - Design philosophy supports extension to other mainstream documentation frameworks. Currently provides production-grade integration for VitePress, with gradual platform coverage as the community evolves, maintaining flexibility in technology choices.

  • ⚛️ Cross-Framework Support - Freely use React, Vue, Solid, Svelte, or any preferred UI framework within documentation. Teams can leverage existing component libraries and development expertise without learning new technology stacks.

  • 🔌 Rapid Integration - Enable Islands capabilities in existing documentation projects with minimal configuration. No code refactoring required, no disruption to existing functionality—progressively enhance interactivity.

  • 📦 Polished Developer Experience - Instant feedback through hot module replacement in development, consistent behavior across dev and production environments. Complete TypeScript support and performance optimization options ensure a smooth experience from development to deployment.

For more details and usage guides, visit the documentation site.

Packages

Package Version (click for changelogs)
@docs-islands/vitepress vitepress version

Contributing

Community contributions are welcome! Please see the Contributing Guide for details.

License

MIT © XiSenao

About

Cross-framework Islands Architecture for documentation sites

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages