![\"Gea\"](\"https://raw.githubusercontent.com/dashersw/gea/master/docs/public/logo.jpg\"){kind=logo}
\n\n[](https://www.npmjs.com/package/@geajs/core)\n[](https://github.com/dashersw/gea/blob/master/LICENSE)\n\n# Gea\n\nA compiler-first reactive JavaScript UI framework with compile-time JSX and proxy-based stores. No virtual DOM — the Vite plugin analyzes your JSX at build time and generates surgical DOM patches that update only what changed. A hello-world production build is 121 B brotli; an equivalent interactive todo ships 4.9 kb of brotli JavaScript.\n\nSvelte made \"compile the framework away\" famous. Gea takes the phrase literally: in a static hello-world app, the framework runtime disappears from the bundle.\n\n## Compile To Almost Nothing\n\nIn a fresh Vite production hello-world build, Gea ships **121 B** of brotli JavaScript. The equivalent Solid build ships 3.6 kb, Svelte ships 8.5 kb, Vue ships 20.7 kb, and React ships 50.8 kb.\n\n| Framework | Version | Raw minified JS | Brotli JS | Brotli vs Gea |\n| --- | --- | ---: | ---: | ---: |\n| Gea | 1.3.0 | 214 B | **121 B** | 1.0x |\n| Solid | 1.9.12 | 10,196 B | 3,601 B | 29.8x |\n| Svelte | 5.55.5 | 23,461 B | 8,537 B | 70.6x |\n| Vue | 3.5.33 | 58,174 B | 20,711 B | 171.2x |\n| React | 19.2.5 / React DOM 19.2.5 | 189,717 B | 50,816 B | 420.0x |\n\nMeasured from fresh Vite 8.0.10 production apps, summing JavaScript assets only. Gea used the compiled component output; React, Vue, and Svelte used equivalent minimal hello-world components.\n\n## Stays Lean When The App Does Work\n\nHello world proves the compiler can disappear. Todo proves the runtime stays lean when the app actually does something.\n\nIn an equivalent interactive todo app with reactive state, input handling, filtering, item updates, and identical CSS, Gea ships **4.9 kb** of brotli JavaScript. Solid ships 5.7 kb, Svelte ships 13.7 kb, Vue ships 22.6 kb, and React ships 51.5 kb.\n\n| Framework | Version | Minified JS raw | Minified JS brotli | Total raw JS+CSS | Total brotli JS+CSS |\n| --- | --- | ---: | ---: | ---: | ---: |\n| Gea | 1.3.0 | 15,265 B | **4,850 B** | 17,976 B | **5,607 B** |\n| Solid | 1.9.12 | 16,181 B | 5,721 B | 18,892 B | 6,485 B |\n| Svelte | 5.55.5 | 38,812 B | 13,661 B | 41,523 B | 14,429 B |\n| Vue | 3.5.33 | 63,676 B | 22,585 B | 66,387 B | 23,411 B |\n| React | 19.2.5 / React DOM 19.2.5 | 192,330 B | 51,460 B | 195,041 B | 52,287 B |\n\nMeasured from fresh Vite production builds in `/tmp/gea-todo-framework-size-compare`. CSS was identical across all builds: 2,711 B raw, 746 B brotli.\n\n## Philosophy\n\nGea's guiding principle is that JavaScript code should be simple and understandable. A framework should not invent new programming concepts or expect you to conform to arbitrary rules. You write regular, idiomatic JavaScript — classes with state and methods, functions that return markup, getters for derived values — and Gea makes it reactive under the hood.\n\nThere are no signals, no hooks, no dependency arrays, no compiler directives, and no framework-specific primitives. The only concept Gea introduces is the `Store` class, which is just an ordinary class whose properties happen to be observed by a proxy. Everything else — class inheritance, method calls, property access, `Array.map`, ternary expressions — is standard JavaScript you already know.\n\nThe \"magic\" lives entirely in the build step. The Vite plugin analyzes your code at compile time, figures out which DOM nodes depend on which state, and generates the wiring. At runtime, you get clean, readable, object-oriented code that just works.\n\n## Performance\n\nGea is the fastest compiled UI framework — benchmarked with the [js-framework-benchmark](https://github.com/krausest/js-framework-benchmark) suite, the industry-standard stress test covering row creation, updates, swaps, selection, and deletion on large tables.\n\n| Framework | Weighted geometric mean |\n| --- | --- |\n| vanillajs | 1.00 |\n| **Gea 1.3** | **1.02** |\n| Solid 1.9 | 1.10 |\n| Svelte 5 | 1.10 |\n| Vue 3.6 | 1.22 |\n| React 19.2 | 1.43 |\n\nLower is better (1.00 = fastest). Gea outperforms every compiled framework while requiring zero framework-specific concepts — no signals, no hooks, no compiler directives. It's not just the DX — it's the fastest, too. [Full benchmark report](https://geajs.com/benchmark-report.html)\n\n## Quick Start\n\n```bash\nnpm create gea@latest my-app\ncd my-app\nnpm install\nnpm run dev\n```\n\nOr add Gea to an existing Vite project:\n\n```bash\nnpm install @geajs/core @geajs/vite-plugin\n```\n\n```js\n// vite.config.ts\nimport { defineConfig } from 'vite'\nimport { geaPlugin } from '@geajs/vite-plugin'\n\nexport default defineConfig({\n plugins: [geaPlugin()]\n})\n```\n\n## TypeScript\n\nGea provides full JSX type-checking via TypeScript's `jsxImportSource`. Add this to your `tsconfig.json`:\n\n```json\n{\n \"compilerOptions\": {\n \"jsx\": \"react-jsx\",\n \"jsxImportSource\": \"@geajs/core\"\n }\n}\n```\n\nThis gives you prop autocompletion, type errors on invalid attributes, and hover types in any TypeScript-aware editor — VS Code, Cursor, Vim, Zed — without framework-specific plugins.\n\nUse `declare props` on class components for typed props:\n\n```tsx\nexport default class UserCard extends Component {\n declare props: { name: string; email: string; onSelect?: () => void }\n\n template({ name, email, onSelect }: this['props']) {\n return (\n Body text goes here.
\n