Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs: restore Starlight site and landing, inject Doxygen version

yhh384ecbcee101
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 502da90fa..85ab22f67 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -32,7 +32,9 @@ jobs:
- name: Build Doxygen API Docs
working-directory: docs
- run: doxygen Doxyfile
+ run: |
+ export ESTELLA_VERSION=$(node -p "require('../desktop/package.json').version")
+ doxygen Doxyfile
- name: Install Astro Dependencies
working-directory: docs/astro
diff --git a/docs/Doxyfile b/docs/Doxyfile
index f82684936..6ba158bcb 100644
--- a/docs/Doxyfile
+++ b/docs/Doxyfile
@@ -6,7 +6,7 @@
#---------------------------------------------------------------------------
PROJECT_NAME = "Estella"
-PROJECT_NUMBER = "0.1.0"
+PROJECT_NUMBER = $(ESTELLA_VERSION)
PROJECT_BRIEF = "A fast 2D game engine powered by WebAssembly and ECS"
PROJECT_LOGO =
diff --git a/docs/SITE.md b/docs/SITE.md
index 0ca05f347..246e9e6e1 100644
--- a/docs/SITE.md
+++ b/docs/SITE.md
@@ -4,11 +4,11 @@ The published documentation site ([estellaengine.com/docs](https://estellaengine
is built with **Astro Starlight** (guides) and **Doxygen** (C++ API reference),
merged into a single static bundle.
-> 🚧 **Status:** the site sources (`docs/astro/`, `docs/landing/`) are being
-> restored into this repository. The `docs.yml` workflow and the `build.sh` /
-> `build.ps1` scripts below reference those directories and only work once the
-> sources land. Until then this document describes the **target** build and
-> publish flow.
+The Starlight site lives in `docs/astro/` and the landing page in `docs/landing/`.
+The Doxygen API version (`PROJECT_NUMBER`) is injected at build time from
+`desktop/package.json` (the single app-version source) via the `ESTELLA_VERSION`
+environment variable — see `build.sh`, `build.ps1`, and
+`.github/workflows/docs.yml`.
## Structure
diff --git a/docs/astro/astro.config.mjs b/docs/astro/astro.config.mjs
new file mode 100644
index 000000000..62ef2cac0
--- /dev/null
+++ b/docs/astro/astro.config.mjs
@@ -0,0 +1,49 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+// The site is deployed under estellaengine.com/docs (docs.yml merges this build
+// into docs/dist/docs/), so everything is served from the /docs base path.
+export default defineConfig({
+ site: 'https://estellaengine.com',
+ base: '/docs',
+ outDir: './dist',
+ integrations: [
+ starlight({
+ title: 'Estella',
+ description: 'A fast 2D game engine powered by WebAssembly and ECS.',
+ social: [
+ { icon: 'github', label: 'GitHub', href: 'https://github.com/esengine/estella' },
+ { icon: 'discord', label: 'Discord', href: 'https://discord.gg/sAX6PXZ9' },
+ ],
+ editLink: {
+ baseUrl: 'https://github.com/esengine/estella/edit/master/docs/astro/',
+ },
+ sidebar: [
+ {
+ label: 'Getting Started',
+ items: [
+ { label: 'Introduction', slug: 'getting-started/introduction' },
+ { label: 'Installation', slug: 'getting-started/installation' },
+ { label: 'Quick Start', slug: 'getting-started/quick-start' },
+ ],
+ },
+ {
+ label: 'Core Concepts',
+ items: [
+ { label: 'ECS Architecture', slug: 'core-concepts/ecs' },
+ { label: 'Components', slug: 'core-concepts/components' },
+ { label: 'Systems', slug: 'core-concepts/systems' },
+ ],
+ },
+ {
+ label: 'Reference',
+ items: [
+ { label: 'C++ API (Doxygen)', link: '/docs/api/html/', attrs: { target: '_blank' } },
+ { label: 'Architecture', link: 'https://github.com/esengine/estella/blob/master/docs/ARCHITECTURE.md' },
+ ],
+ },
+ ],
+ }),
+ ],
+});
diff --git a/docs/astro/package.json b/docs/astro/package.json
new file mode 100644
index 000000000..6346fac45
--- /dev/null
+++ b/docs/astro/package.json
@@ -0,0 +1,17 @@
+{
+ "name": "@estella/docs-site",
+ "type": "module",
+ "version": "0.0.0",
+ "private": true,
+ "scripts": {
+ "dev": "astro dev",
+ "build": "astro build",
+ "preview": "astro preview",
+ "check": "astro check"
+ },
+ "dependencies": {
+ "@astrojs/starlight": "^0.41.1",
+ "astro": "^7.0.4",
+ "sharp": "^0.35.2"
+ }
+}
diff --git a/docs/astro/src/content.config.ts b/docs/astro/src/content.config.ts
new file mode 100644
index 000000000..6a7b7a02b
--- /dev/null
+++ b/docs/astro/src/content.config.ts
@@ -0,0 +1,7 @@
+import { defineCollection } from 'astro:content';
+import { docsLoader } from '@astrojs/starlight/loaders';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+ docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+};
diff --git a/docs/astro/src/content/docs/core-concepts/components.mdx b/docs/astro/src/content/docs/core-concepts/components.mdx
new file mode 100644
index 000000000..9ddb5057d
--- /dev/null
+++ b/docs/astro/src/content/docs/core-concepts/components.mdx
@@ -0,0 +1,43 @@
+---
+title: Components
+description: Declaring and using components with defineComponent.
+---
+
+A **component** is a small, plain data struct attached to an entity. Declare one
+with `defineComponent`, giving it a name and its default values:
+
+```typescript
+import { defineComponent } from 'esengine';
+
+const Speed = defineComponent('Speed', { value: 200 });
+const Health = defineComponent('Health', { current: 100, max: 100 });
+```
+
+The defaults define both the shape (fields and types) and the initial values a
+new instance gets. Components are pure data — no methods, no behavior. Behavior
+lives in [systems](/docs/core-concepts/systems/).
+
+## Built-in components
+
+The SDK ships engine components you query alongside your own, for example:
+
+- `LocalTransform` — position, rotation, and scale.
+- `Sprite` — a textured quad.
+- `Camera` — a view into the world.
+
+## Reading and writing
+
+Systems receive component data through a query. Wrap a component in `Mut(...)`
+when a system writes to it, so change detection and the renderer know the data
+was touched:
+
+```typescript
+Query(Mut(LocalTransform), Speed)
+// LocalTransform is written; Speed is read-only
+```
+
+<br />
+
+Under the hood a component is a C++ struct annotated with `ES_COMPONENT` /
+`ES_PROPERTY`; the cross-boundary layout is generated, so the TypeScript
+component and the C++ struct are always in sync.
diff --git a/docs/astro/src/content/docs/core-concepts/ecs.mdx b/docs/astro/src/content/docs/core-concepts/ecs.mdx
new file mode 100644
index 000000000..7a951d3ea
--- /dev/null
+++ b/docs/astro/src/content/docs/core-concepts/ecs.mdx
@@ -0,0 +1,41 @@
+---
+title: ECS Architecture
+description: Entities, components, and systems in Estella.
+---
+
+Estella is built on an **Entity-Component-System** (ECS) architecture. Instead
+of deep class hierarchies, game state is plain data in components, and behavior
+lives in systems that run over that data.
+
+- **Entity** — an identifier. It owns no data and no behavior; it is just a
+ handle that components attach to.
+- **Component** — a small, plain data struct (position, velocity, sprite). An
+ entity is defined by which components it has.
+- **System** — a function that runs each frame over every entity matching a
+ query, reading and writing components.
+
+## Why data-oriented
+
+Components are stored in a single cache-friendly layer (a sparse set) so that a
+system iterating "all entities with a `LocalTransform` and a `Speed`" walks
+contiguous memory. Storage lives in the C++/WebAssembly core, and the SDK reads
+it with zero copies through a generated, hash-checked memory layout — so the
+TypeScript and C++ views of a component can never silently drift apart.
+
+## The authored surface
+
+You compose a game from three SDK primitives:
+
+- [`defineComponent`](/docs/core-concepts/components/) — declare a component type.
+- [`defineSystem`](/docs/core-concepts/systems/) — declare a system and what it
+ queries.
+- `App` / plugins — assemble systems, resources, and subsystems (physics, spine,
+ tilemap, UI, audio, scene) into a running game.
+
+```typescript
+import { App } from 'esengine';
+
+const app = new App();
+// register components, systems, and plugins on the app…
+app.run();
+```
diff --git a/docs/astro/src/content/docs/core-concepts/systems.mdx b/docs/astro/src/content/docs/core-concepts/systems.mdx
new file mode 100644
index 000000000..ee7941042
--- /dev/null
+++ b/docs/astro/src/content/docs/core-concepts/systems.mdx
@@ -0,0 +1,51 @@
+---
+title: Systems
+description: Declaring systems with defineSystem, Query, Res, and Mut.
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+A **system** is a function that runs each frame. You declare what it needs — a
+query over components, plus resources and events — and Estella calls it with
+exactly those, in the schedule.
+
+```typescript
+import {
+ defineComponent, defineSystem, addSystem,
+ Query, Mut, Res, Time, LocalTransform
+} from 'esengine';
+
+const Speed = defineComponent('Speed', { value: 200 });
+
+addSystem(defineSystem(
+ [Res(Time), Query(Mut(LocalTransform), Speed)],
+ (time, query) => {
+ for (const [entity, transform, speed] of query) {
+ transform.position.x += speed.value * time.delta;
+ }
+ }
+));
+```
+
+## Parameters
+
+A system's first argument is its **parameter list** — the data it will receive,
+in order:
+
+- **`Query(...)`** — iterate every entity that has all listed components. Each
+ iteration yields `[entity, ...components]`.
+- **`Mut(Component)`** — a component the system writes. Unwrapped components are
+ read-only.
+- **`Res(Resource)`** — a shared resource, such as `Time` for frame timing.
+
+<Aside type="caution">
+ Only wrap a component in `Mut` when you actually write it. Read-only queries
+ let the engine skip needless change-detection and let more systems run in
+ parallel.
+</Aside>
+
+## Running order
+
+Systems are organized by a **schedule**. Register a system with `addSystem`, or
+add it through a plugin on your `App`. Scene systems only run while their scene
+is active, so multiple scenes can coexist in one world without interfering.
diff --git a/docs/astro/src/content/docs/getting-started/installation.mdx b/docs/astro/src/content/docs/getting-started/installation.mdx
new file mode 100644
index 000000000..5c1399c65
--- /dev/null
+++ b/docs/astro/src/content/docs/getting-started/installation.mdx
@@ -0,0 +1,62 @@
+---
+title: Installation
+description: Install the Estella editor, or build the engine from source.
+---
+
+import { Tabs, TabItem, Steps, Aside } from '@astrojs/starlight/components';
+
+<Tabs>
+ <TabItem label="Use the editor">
+ <Steps>
+
+ 1. Download the latest editor from the
+ [releases page](https://github.com/esengine/estella/releases).
+
+ 2. Install and open it, then click **New Project**.
+
+ 3. Enter a project name and location, and click **Create**. The editor opens
+ a default scene with a Camera entity.
+
+ </Steps>
+
+ <Aside type="note">
+ Installers are currently unsigned, so on first launch Windows SmartScreen
+ or macOS Gatekeeper may warn about an unknown developer — choose **Run
+ anyway** / allow it in **System Settings → Privacy & Security**.
+ </Aside>
+ </TabItem>
+
+ <TabItem label="Build from source">
+ Prerequisites:
+
+ - **Node.js** ≥ 18 and **pnpm** ≥ 8
+ - **Emscripten** 5.0.0 (exact version, for CI parity)
+
+ <Steps>
+
+ 1. Clone and install:
+
+ ```bash
+ git clone https://github.com/esengine/estella.git
+ cd estella
+ pnpm install
+ ```
+
+ 2. Build the engine, SDK, and sync to the editor:
+
+ ```bash
+ node build-tools/cli.js build -t all
+ ```
+
+ 3. Run the editor:
+
+ ```bash
+ cd desktop && pnpm dev
+ ```
+
+ </Steps>
+
+ See [CONTRIBUTING.md](https://github.com/esengine/estella/blob/master/CONTRIBUTING.md)
+ for the full build reference.
+ </TabItem>
+</Tabs>
diff --git a/docs/astro/src/content/docs/getting-started/introduction.mdx b/docs/astro/src/content/docs/getting-started/introduction.mdx
new file mode 100644
index 000000000..8dd28ff1e
--- /dev/null
+++ b/docs/astro/src/content/docs/getting-started/introduction.mdx
@@ -0,0 +1,41 @@
+---
+title: Introduction
+description: What Estella is and why it exists.
+---
+
+Estella is a **2D game engine** with a TypeScript SDK driven by a
+high-performance **C++/WebAssembly** backend. It ships with a visual editor for
+scene editing and project management, and outputs games that run in **web
+browsers** and **WeChat MiniGames**.
+
+## Why Estella?
+
+- **Fast** — the C++ rendering pipeline is compiled to WebAssembly, not
+ interpreted JavaScript.
+- **Type-safe** — a first-class TypeScript SDK with `defineSystem`,
+ `defineComponent`, and `Query`.
+- **Data-oriented** — an Entity-Component-System architecture for scalable game
+ logic.
+- **Visual editor** — scene hierarchy, inspector, and asset browser; no JSON
+ editing.
+- **Cross-platform** — one codebase, deployed to web browsers and WeChat
+ MiniGames.
+- **Spine & Physics** — built-in Spine animation and physics support.
+
+## How it fits together
+
+| Layer | What it does |
+|-------|--------------|
+| **TypeScript SDK** (`esengine`) | The authored surface: `App`, `World`, systems, components, queries, plugins. |
+| **WasmBridge** | The single boundary between the SDK and the engine, with a generated, hash-checked memory layout. |
+| **C++ / WebAssembly** | The engine core: ECS storage, the renderer (`GfxDevice`), resources, particles, tilemaps, text. |
+
+For the full architecture, see
+[`ARCHITECTURE.md`](https://github.com/esengine/estella/blob/master/docs/ARCHITECTURE.md).
+
+## Next steps
+
+- [Installation](/docs/getting-started/installation/) — get the editor or build
+ from source.
+- [Quick Start](/docs/getting-started/quick-start/) — create a project and write
+ your first system.
diff --git a/docs/astro/src/content/docs/getting-started/quick-start.mdx b/docs/astro/src/content/docs/getting-started/quick-start.mdx
new file mode 100644
index 000000000..e47c3848f
--- /dev/null
+++ b/docs/astro/src/content/docs/getting-started/quick-start.mdx
@@ -0,0 +1,49 @@
+---
+title: Quick Start
+description: Create a project and write your first system.
+---
+
+import { Steps, Aside } from '@astrojs/starlight/components';
+
+This walks through a first moving entity: add it in the editor, then drive it
+with a system written in TypeScript.
+
+<Steps>
+
+1. **Create a project.** In the editor, click **New Project**, name it, and
+ click **Create**. You get a default scene with a Camera entity.
+
+2. **Add an entity.** In the scene hierarchy, add an entity and give it a
+ `Sprite` and a `LocalTransform` component in the inspector.
+
+3. **Write a system.** Add a TypeScript file to your project's scripts and
+ register a system that moves everything with a `Speed` component:
+
+ ```typescript
+ import {
+ defineComponent, defineSystem, addSystem,
+ Query, Mut, Res, Time, LocalTransform
+ } from 'esengine';
+
+ const Speed = defineComponent('Speed', { value: 200 });
+
+ addSystem(defineSystem(
+ [Res(Time), Query(Mut(LocalTransform), Speed)],
+ (time, query) => {
+ for (const [entity, transform, speed] of query) {
+ transform.position.x += speed.value * time.delta;
+ }
+ }
+ ));
+ ```
+
+4. **Preview.** Add the `Speed` component to your entity, then press **F5** to
+ run the scene. The sprite moves.
+
+</Steps>
+
+<Aside type="tip">
+ `Res(Time)` gives you frame timing, `Query(...)` iterates entities that have
+ every listed component, and `Mut(...)` marks a component you intend to write.
+ See [Systems](/docs/core-concepts/systems/) for the full query vocabulary.
+</Aside>
diff --git a/docs/astro/src/content/docs/index.mdx b/docs/astro/src/content/docs/index.mdx
new file mode 100644
index 000000000..8cbb235c3
--- /dev/null
+++ b/docs/astro/src/content/docs/index.mdx
@@ -0,0 +1,34 @@
+---
+title: Estella
+description: A fast 2D game engine powered by WebAssembly and ECS.
+template: splash
+hero:
+ tagline: A fast 2D game engine with a TypeScript SDK and a C++/WebAssembly backend. Build games for the web and WeChat MiniGames.
+ actions:
+ - text: Get Started
+ link: /docs/getting-started/introduction/
+ icon: right-arrow
+ - text: View on GitHub
+ link: https://github.com/esengine/estella
+ icon: external
+ variant: minimal
+---
+
+import { Card, CardGrid } from '@astrojs/starlight/components';
+
+<CardGrid stagger>
+ <Card title="Fast" icon="rocket">
+ A C++ rendering pipeline compiled to WebAssembly — not interpreted
+ JavaScript.
+ </Card>
+ <Card title="Type-safe" icon="seti:typescript">
+ A first-class TypeScript SDK: `defineComponent`, `defineSystem`, `Query`,
+ `Commands`, `Res`.
+ </Card>
+ <Card title="Data-oriented" icon="puzzle">
+ An Entity-Component-System core with a single cache-friendly storage layer.
+ </Card>
+ <Card title="Cross-platform" icon="laptop">
+ One codebase, deployed to web browsers and WeChat MiniGames.
+ </Card>
+</CardGrid>
diff --git a/docs/astro/tsconfig.json b/docs/astro/tsconfig.json
new file mode 100644
index 000000000..8bf91d3bb
--- /dev/null
+++ b/docs/astro/tsconfig.json
@@ -0,0 +1,5 @@
+{
+ "extends": "astro/tsconfigs/strict",
+ "include": [".astro/types.d.ts", "**/*"],
+ "exclude": ["dist"]
+}
diff --git a/docs/build.ps1 b/docs/build.ps1
index f227ab78a..665096c55 100644
--- a/docs/build.ps1
+++ b/docs/build.ps1
@@ -27,6 +27,8 @@ function Build-Doxygen {
exit 1
}
+ # PROJECT_NUMBER is injected from the single app-version source.
+ $env:ESTELLA_VERSION = (node -p "require('../desktop/package.json').version")
doxygen Doxyfile
Write-Host "Doxygen build complete: docs/api/html/" -ForegroundColor Green
diff --git a/docs/build.sh b/docs/build.sh
index 672cc708c..4d0f4e5b3 100644
--- a/docs/build.sh
+++ b/docs/build.sh
@@ -27,6 +27,8 @@ build_doxygen() {
exit 1
fi
+ # PROJECT_NUMBER is injected from the single app-version source.
+ export ESTELLA_VERSION="$(node -p "require('../desktop/package.json').version" 2>/dev/null || echo '')"
doxygen Doxyfile
echo "Doxygen build complete: docs/api/html/"
diff --git a/docs/landing/editor-screenshot.png b/docs/landing/editor-screenshot.png
new file mode 100644
index 000000000..afb448d51
Binary files /dev/null and b/docs/landing/editor-screenshot.png differ
diff --git a/docs/landing/index.html b/docs/landing/index.html
new file mode 100644
index 000000000..b27205e24
--- /dev/null
+++ b/docs/landing/index.html
@@ -0,0 +1,178 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <title>Estella — A fast 2D game engine powered by WebAssembly and ECS</title>
+ <meta name="description" content="Estella is a 2D game engine with a TypeScript SDK and a C++/WebAssembly backend. Build games for the web and WeChat MiniGames, with a visual editor." />
+ <link rel="canonical" href="https://estellaengine.com/" />
+ <meta property="og:type" content="website" />
+ <meta property="og:title" content="Estella — A fast 2D game engine" />
+ <meta property="og:description" content="A TypeScript SDK on a C++/WebAssembly backend. Web + WeChat MiniGames, with a visual editor." />
+ <meta property="og:image" content="https://estellaengine.com/og-image.png" />
+ <meta property="og:url" content="https://estellaengine.com/" />
+ <meta name="twitter:card" content="summary_large_image" />
+ <style>
+ :root {
+ --bg: #0e121b;
+ --bg-soft: #151b28;
+ --border: #232c3d;
+ --fg: #e6ebf5;
+ --muted: #93a1bd;
+ --accent: #7c9cf5;
+ --accent-2: #a78bfa;
+ --radius: 14px;
+ }
+ * { box-sizing: border-box; }
+ html { scroll-behavior: smooth; }
+ body {
+ margin: 0;
+ background: var(--bg);
+ color: var(--fg);
+ font: 16px/1.6 -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+ -webkit-font-smoothing: antialiased;
+ }
+ a { color: inherit; text-decoration: none; }
+ .wrap { max-width: 1080px; margin: 0 auto; padding: 0 24px; }
+
+ header {
+ position: sticky; top: 0; z-index: 10;
+ backdrop-filter: blur(10px);
+ background: color-mix(in srgb, var(--bg) 78%, transparent);
+ border-bottom: 1px solid var(--border);
+ }
+ .nav { display: flex; align-items: center; gap: 20px; height: 64px; }
+ .brand { font-weight: 700; letter-spacing: -0.01em; font-size: 18px; }
+ .brand span { background: linear-gradient(90deg, var(--accent), var(--accent-2)); -webkit-background-clip: text; background-clip: text; color: transparent; }
+ .nav .spacer { flex: 1; }
+ .nav a.link { color: var(--muted); font-size: 14px; }
+ .nav a.link:hover { color: var(--fg); }
+
+ .btn {
+ display: inline-flex; align-items: center; gap: 8px;
+ padding: 10px 18px; border-radius: 10px; font-weight: 600; font-size: 14px;
+ border: 1px solid var(--border); background: var(--bg-soft); color: var(--fg);
+ transition: transform .12s ease, border-color .12s ease, background .12s ease;
+ }
+ .btn:hover { transform: translateY(-1px); border-color: color-mix(in srgb, var(--accent) 50%, var(--border)); }
+ .btn.primary {
+ border-color: transparent;
+ background: linear-gradient(90deg, var(--accent), var(--accent-2));
+ color: #0b1020;
+ }
+
+ .hero { padding: 96px 0 64px; text-align: center; }
+ .badge {
+ display: inline-block; padding: 5px 12px; margin-bottom: 22px;
+ border: 1px solid var(--border); border-radius: 999px;
+ color: var(--muted); font-size: 13px;
+ }
+ .hero h1 {
+ font-size: clamp(36px, 6vw, 60px); line-height: 1.05; margin: 0 0 18px;
+ letter-spacing: -0.03em; font-weight: 800;
+ }
+ .hero h1 .grad { background: linear-gradient(90deg, var(--accent), var(--accent-2)); -webkit-background-clip: text; background-clip: text; color: transparent; }
+ .hero p.lead { max-width: 640px; margin: 0 auto 30px; color: var(--muted); font-size: 19px; }
+ .cta { display: flex; gap: 12px; justify-content: center; flex-wrap: wrap; }
+
+ .shot { margin: 64px auto 0; max-width: 960px; }
+ .shot img {
+ width: 100%; height: auto; display: block; border-radius: var(--radius);
+ border: 1px solid var(--border);
+ box-shadow: 0 30px 80px -30px rgba(124, 156, 245, .35);
+ }
+
+ section.features { padding: 96px 0 32px; }
+ .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 18px; }
+ .card {
+ padding: 22px; border: 1px solid var(--border); border-radius: var(--radius);
+ background: var(--bg-soft);
+ }
+ .card h3 { margin: 0 0 8px; font-size: 17px; }
+ .card p { margin: 0; color: var(--muted); font-size: 14px; }
+
+ section.code { padding: 64px 0; }
+ section.code h2 { text-align: center; font-size: 28px; letter-spacing: -0.02em; margin: 0 0 8px; }
+ section.code p.sub { text-align: center; color: var(--muted); margin: 0 0 28px; }
+ pre {
+ margin: 0 auto; max-width: 720px; overflow: auto;
+ background: #0b0f17; border: 1px solid var(--border); border-radius: var(--radius);
+ padding: 20px 22px; font: 13.5px/1.7 "SFMono-Regular", ui-monospace, "JetBrains Mono", Menlo, Consolas, monospace;
+ color: #cdd6e6;
+ }
+ .tok-k { color: #a78bfa; } .tok-s { color: #86e1a6; } .tok-f { color: #7c9cf5; } .tok-c { color: #5b6577; }
+
+ footer { border-top: 1px solid var(--border); padding: 40px 0 60px; color: var(--muted); font-size: 14px; }
+ .foot { display: flex; gap: 20px; flex-wrap: wrap; align-items: center; }
+ .foot .spacer { flex: 1; }
+ .foot a:hover { color: var(--fg); }
+ </style>
+</head>
+<body>
+ <header>
+ <div class="wrap nav">
+ <div class="brand"><span>Estella</span></div>
+ <div class="spacer"></div>
+ <a class="link" href="/docs/getting-started/introduction/">Docs</a>
+ <a class="link" href="https://github.com/esengine/estella">GitHub</a>
+ <a class="btn" href="https://github.com/esengine/estella/releases">Download</a>
+ </div>
+ </header>
+
+ <main>
+ <section class="hero wrap">
+ <span class="badge">C++/WebAssembly · TypeScript SDK · ECS</span>
+ <h1>A fast <span class="grad">2D game engine</span><br />for the web</h1>
+ <p class="lead">
+ Estella pairs a first-class TypeScript SDK with a C++/WebAssembly
+ rendering core, and ships a visual editor. Build once, deploy to web
+ browsers and WeChat MiniGames.
+ </p>
+ <div class="cta">
+ <a class="btn primary" href="/docs/getting-started/quick-start/">Get Started →</a>
+ <a class="btn" href="https://github.com/esengine/estella">View on GitHub</a>
+ </div>
+ <div class="shot">
+ <img src="/editor-screenshot.png" alt="The Estella editor" loading="lazy" />
+ </div>
+ </section>
+
+ <section class="features wrap">
+ <div class="grid">
+ <div class="card"><h3>Fast</h3><p>A C++ rendering pipeline compiled to WebAssembly — not interpreted JavaScript.</p></div>
+ <div class="card"><h3>Type-safe SDK</h3><p><code>defineComponent</code>, <code>defineSystem</code>, <code>Query</code>, <code>Commands</code>, <code>Res</code>.</p></div>
+ <div class="card"><h3>Data-oriented</h3><p>An ECS core with a single cache-friendly component storage layer.</p></div>
+ <div class="card"><h3>Cross-platform</h3><p>One codebase, deployed to web browsers and WeChat MiniGames.</p></div>
+ <div class="card"><h3>Visual editor</h3><p>Scene hierarchy, inspector, and asset browser — no JSON editing.</p></div>
+ <div class="card"><h3>Spine &amp; Physics</h3><p>Built-in Spine skeletal animation and physics support.</p></div>
+ </div>
+ </section>
+
+ <section class="code wrap">
+ <h2>Write game logic in TypeScript</h2>
+ <p class="sub">Declare what a system needs; Estella runs it over matching entities each frame.</p>
+<pre><span class="tok-k">const</span> Speed = <span class="tok-f">defineComponent</span>(<span class="tok-s">'Speed'</span>, { value: <span class="tok-s">200</span> });
+
+<span class="tok-f">addSystem</span>(<span class="tok-f">defineSystem</span>(
+ [<span class="tok-f">Res</span>(Time), <span class="tok-f">Query</span>(<span class="tok-f">Mut</span>(LocalTransform), Speed)],
+ (time, query) => {
+ <span class="tok-k">for</span> (<span class="tok-k">const</span> [entity, transform, speed] <span class="tok-k">of</span> query) {
+ transform.position.x += speed.value * time.delta;
+ }
+ }
+));</pre>
+ </section>
+ </main>
+
+ <footer>
+ <div class="wrap foot">
+ <div class="brand"><span>Estella</span></div>
+ <div class="spacer"></div>
+ <a href="/docs/getting-started/introduction/">Documentation</a>
+ <a href="https://github.com/esengine/estella">GitHub</a>
+ <a href="https://discord.gg/sAX6PXZ9">Discord</a>
+ <a href="https://github.com/esengine/estella/blob/master/LICENSE">Apache-2.0</a>
+ </div>
+ </footer>
+</body>
+</html>
diff --git a/docs/landing/og-image.png b/docs/landing/og-image.png
new file mode 100644
index 000000000..afb448d51
Binary files /dev/null and b/docs/landing/og-image.png differ
diff --git a/docs/landing/robots.txt b/docs/landing/robots.txt
new file mode 100644
index 000000000..c02437ba7
--- /dev/null
+++ b/docs/landing/robots.txt
@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://estellaengine.com/docs/sitemap-index.xml