From cd79e160453c1e1a3a76d89c5609f89a48cccecb Mon Sep 17 00:00:00 2001 From: Thomas David Date: Thu, 16 Jul 2026 10:01:55 +0200 Subject: [PATCH 1/2] Update Coralite documentation with detailed framework description and specs Updates the project specification in coralite.md to accurately reflect its capabilities as an Isomorphic Web Component Framework. This commit includes several updates: - Changes the repository owner from `tjdav` to `tjdavid`. - Updates the official homepage domain from `coralite.io` to `coralite.dev`. - Switches the licensing model from AGPL-3.0 to MPL-2.0. - Significantly expands the description, detailing key features such as Isomorphism Built-In, Opt-Out Hydration, and O(1) Microtask Reactivity, providing a comprehensive overview of the framework's architecture. --- src/site/generators/coralite.md | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/src/site/generators/coralite.md b/src/site/generators/coralite.md index ee3cb5b9..589154d3 100644 --- a/src/site/generators/coralite.md +++ b/src/site/generators/coralite.md @@ -1,15 +1,27 @@ --- title: Coralite -repo: tjdav/coralite -homepage: https://coralite.io +repo: tjdavid/coralite +homepage: https://coralite.dev language: - JavaScript - TypeScript license: - - AGPL-3.0 + - MPL-2.0 templates: - HTML - Web Components -description: Build for the Web, With the Web! +description: An Isomorphic Web Component Framework for fast, interactive SPAs, dynamic websites, and static sites. --- -Build with HTML Modules. Coralite is a static site generator for web developers who prefer native technologies. Create websites using standard HTML, CSS, and JavaScript – no new syntax to learn. Coralite features a flexible templating system with custom elements, powerful data handling, and extendable plugins for automated content organization and more.` \ No newline at end of file +Build for the Web, With the Web! + +Coralite is a powerful **Isomorphic Web Component Framework** designed to build fast, interactive single-page applications (SPAs), dynamic websites, and static sites. It seamlessly blends the initial load speed of Server-Side Rendering (SSR) with robust, high-performance client-side hydration, giving you total flexibility over your rendering strategy using standard Web Components. + +Coralite stands out by actively fixing the most frustrating pain points of modern web development: + +* **True Native Web Components**: Abandon the verbose `class extends HTMLElement` syntax. Coralite uses a clean, ergonomic `defineComponent` flat-options API (`attributes`, `server`, `getters`, `client`) that outputs true native Custom Elements. +* **Isomorphism Built-In**: Fetch database or API records in the `server()` block during SSR. Coralite automatically serializes that data, hydrates it seamlessly into a unified reactive state on the client, and safely strips the `server()` code entirely from your browser bundle. +* **Opt-Out Hydration**: For purely static sections, simply append the `no-hydration` attribute to your HTML tag. Coralite will render it on the server but skip client-side hydration completely, keeping your JavaScript bundle incredibly lean. +* **The "Smart State, Dumb Template" Paradigm**: Templates are strictly declarative—no logic loops, inline expressions, or dot-notation allowed. All UI logic resides in pure, synchronous JavaScript `getters` which map cleanly to native HTML attributes. +* **Scoped CSS without Shadow DOM**: Coralite completely bypasses Shadow DOM limitations by using compiler-generated instance identifiers to perfectly scope your CSS in the Light DOM. +* **O(1) Microtask Reactivity (No Virtual DOM)**: Mutate state in the `client()` controller block, and Coralite automatically schedules surgical DOM updates in the next microtask queue with O(1) precision via a compiler-generated hydration map. +* **Async Race-Condition Immunity**: Coralite’s reactive engine handles asynchronous data with built-in version locks, ensuring your DOM never renders stale data from out-of-order Promise resolutions. \ No newline at end of file From efc0c0d554bf561ea9997be21c9be401cbd15339 Mon Sep 17 00:00:00 2001 From: Thomas David Date: Thu, 16 Jul 2026 10:04:31 +0200 Subject: [PATCH 2/2] Correct Coralite repository name typo --- src/site/generators/coralite.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/site/generators/coralite.md b/src/site/generators/coralite.md index 589154d3..6505fbdf 100644 --- a/src/site/generators/coralite.md +++ b/src/site/generators/coralite.md @@ -1,6 +1,6 @@ --- title: Coralite -repo: tjdavid/coralite +repo: tjdav/coralite homepage: https://coralite.dev language: - JavaScript