@ecopages/core

Ecopages

Ecopages is a static site generator designed with the goal of simplifying the process of creating websites. It is suitable for a range of projects, from blogs to portfolios, emphasizing ease of use and flexibility.

This project is built on a commitment to clarity and simplicity in web development, utilizing modern web technologies without obscuring the process with unnecessary complexity.

Ecopages relies on a minimal set of dependencies, carefully chosen to support its core functionality.

Ecopages is built on the Bun runtime, primarily utilizing Kita and Mdx for rendering. Additionally, it supports Lit Elements and offers experimental integration with React. This setup allows for the extension of the platform with custom rendering functions, providing flexibility to cater to the specific needs of each project. The integrations are designed to be extensible, with no limit to the customization and expansion possibilities.

For styling, Tailwind CSS and PostCSS have been integrated. Notably, we recommend using css stylesheets and @apply directives with Tailwind CSS, diverging from its usual inline styling approach to better suit the structure of Ecopages.

As a project in its early stages, Ecopages is continuously evolving. Users may encounter limitations or areas in need of refinement. We welcome feedback and issue reports via our GitHub repository.

Install

bunx jsr add @ecopages/core

Portable imports first

Use the root package exports for normal Ecopages authoring:

import { EcopagesApp, defineApiHandler, defineGroupHandler } from '@ecopages/core';

Use runtime-specific subpaths only as advanced escape hatches when you explicitly need Bun- or Node-native APIs:

• @ecopages/core/bun
• @ecopages/core/node