Ecosystem Packages
The Ecopages ecosystem is composed of several modular packages. You only install what you need.
Core Packages
| Package | Purpose |
|---|---|
@ecopages/core | The heart of Ecopages. Contains the application adapter, router, and base plugin classes. |
@ecopages/logger | Unified logging utility used across the entire ecosystem. |
Routers
Specialized routers for different application needs.
| Package | Purpose |
|---|---|
@ecopages/browser-router | Standard browser-based router with View Transitions support. |
@ecopages/react-router | React-specific router enabling SPA navigation for React apps. |
Integrations
These packages add support for different rendering engines.
| Package | Purpose |
|---|---|
@ecopages/ecopages-jsx | Ecopages-owned JSX routes with optional Radiant and MDX support. |
@ecopages/kitajs | HTML-first JSX rendering for .kita.tsx routes. |
@ecopages/react | React 19 support with SSR and hydration. |
@ecopages/lit | Lit Web Components integration with SSR support. |
@ecopages/mdx | Standalone MDX for non-React JSX runtimes such as @kitajs/html. |
Processors & Loaders
Tools for processing assets at build time.
| Package | Purpose |
|---|---|
@ecopages/image-processor | Build-time image optimization and responsive image generation. |
@ecopages/content-processor | Build-time MDX content collections with typed virtual modules. See Content Processor. |
@ecopages/postcss-processor | Processes CSS through PostCSS and Tailwind. |
Utilities
| Package | Purpose |
|---|---|
ecopages | Official npm CLI for scaffolding and running Ecopages apps. See also CLI docs. |
@ecopages/file-system | Utilities for file system operations and route discovery. |
@ecopages/radiant | A minimalist web component library for reactive UI. |
@ecopages/scripts-injector | Helper for lazy-loading scripts in the browser. |
Installation Tip
You can install multiple packages at once:
npm install @ecopages/core @ecopages/ecopages-jsx @ecopages/jsx @ecopages/radiant @ecopages/image-processor
pnpm add @ecopages/core @ecopages/ecopages-jsx @ecopages/jsx @ecopages/radiant @ecopages/image-processor
bun add @ecopages/core @ecopages/ecopages-jsx @ecopages/jsx @ecopages/radiant @ecopages/image-processor