Esposter

Experimental. Every published package in this repository is experimental: its exports, build entries and files may change or be removed in any release, a minor one included. See Stability.

Table of Contents

• 🧱 The Stack
• 🏠 Local Development
• 🧭 Architecture
• 📦 Packages
• 🔌 Claude Code Plugins
• 🤝 Community
• ⚖️ License

---

🧱 The Stack

Toolchain

	Vite+ The unified toolchain for the web: Vite, Vitest, oxlint, oxfmt and the vp command in one install.

Frontend

	Nuxt The Intuitive Web Framework, based on Vue, with Pinia for state.
	Vue 🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
	Vuetify 0 🐉 Headless building blocks for Vue, under the app's own UI library.

Backend

	Drizzle ORM TypeScript ORM that feels like writing SQL.
	PostgreSQL PostgreSQL is a powerful, open source object-relational database system with over 35 years of active development that has earned it a strong reputation for reliability, feature robustness, and performance.
	tRPC 🧙‍♀️ Move Fast and Break Nothing. End-to-end typesafe APIs made easy.
	Zod TypeScript-first schema validation with static type inference.

Infrastructure

	Pulumi Infrastructure as Code in any programming language.

Hosting & Domain Providers

	Namecheap ICANN-accredited domain name registrar providing domain name registration and web hosting.
	Railway Infrastructure, Instantly.

🏠 Local Development

Git configuration to enable symlinks

The projects make use of symlinks in the git project. On Windows, this may not work as expected without extra configuration. To configure git to create symlinks on windows, you need to enable the Windows "Developer Mode" setting, and also set the core.symlinks git feature using either of the following commands:

# Global setting
git config --global core.symlinks true

# Local setting
git config core.symlinks true

After applying this setting, you may need to reset your local branch to ensure the files get rewritten as symlinks. Note that this step is destructive and you will want to push any changes you have made prior to resetting your branch.

git reset --hard

Installing Dependencies

1. Install the global Vite+ CLI, then the node and pnpm versions the repository pins:

vp env install

2. Install Node Modules:

pnpm i

3. Install PostgreSQL + PgAdmin. On macOS, brew install postgresql@18 installs the server and brew services start postgresql@18 keeps it running across logins and reboots. Its binaries are in /opt/homebrew/opt/postgresql@18/bin, which is not on PATH until added. The server listens on localhost:5432. The esposter database holds no data worth keeping: pnpm dev runs the migrations on it.

4. Add .env file according to .env.example in apps/web directory.

5. Check what this machine still needs, the tools and logins with the command that installs or logs in to each:

pnpm ai:setup

Checkout the deployment documentation for more information.

Spotlight on macOS

The parity data lives in {data-root}/genshin-parity unless GENSHIN_PARITY_DIRECTORY names another folder. Create {data-root}.noindex as the data folder and make {data-root} a symlink to it: macOS never indexes a *.noindex folder and Spotlight follows no symlink, so every {data-root}/... path still resolves, and a real {data-root} folder must not be created beside the link. Then add node_modules and the pnpm store ({home}/Library/pnpm/store) under System Settings → Spotlight → Search Privacy, which can only be done by hand. The reason is in the machine efficiency design.

Development Server

1. Build the packages to be used by the application:

vp run build:packages

2. Change to the app directory:

cd apps/web

3. Start the development server on http://localhost:3000

pnpm dev

Production

Build the application for production:

pnpm build

Locally preview production build:

pnpm -C apps/web preview

🧭 Architecture

Esposter is a pnpm workspaces monorepo. See monorepo tooling for workspace script orchestration and publishing boundaries. Packages are used directly by the nuxt application via workspace:*.

How AI sessions land their commits, and how those commits are reviewed on the way to main, is in the review docs.

Workspace Graph

Each node's hue and tint are the role its edges give it, darkest at what the repo ships and lightest at what the rest of it stands on; the key is drawn into the image. Regenerate it from the repo root with:

pnpm graph:gen

📦 Packages

Warning

The published packages are built for this repository first. Use them at your own risk: their APIs may change in any release, without a deprecation period, in pursuit of better performance and simpler code.

Package	Description	Published
apps/functions	Serverless Azure Functions backend — push notifications, webhooks, EventGrid	—
apps/infra	Pulumi infrastructure code and migration tools for Azure resources	—
apps/web	Main Nuxt web application — frontend, server routes, tRPC API	—
packages/agent-console-server	Agent console host — Claude Code sessions over a token-gated loopback WebSocket	✓
packages/azure	Azure wire conventions — OData filter clauses, entity key casing, service limits	✓
packages/azure-mock	Mock Azure service classes for local dev and testing	✓
packages/configuration	Shared ESLint, TSConfig, and tsdown build configurations	—
packages/db	Database connection utilities for Drizzle ORM, Azure Table, Blob, and WebPubSub	—
packages/db-mock	In-memory PGlite database factory for unit and integration tests	—
packages/db-schema	Drizzle ORM schemas and migrations (PostgreSQL source of truth)	—
packages/follow-ups	Claude Code plugin — a session's unfinished follow-ups written into a TodoList and drained until none is left	—
packages/genshin-engine	Anime-style open-world engine for three.js WebGPU — toon materials, outlines, post-processing, world kits and music	✓
packages/genshin-interface	Genshin's 2D interface — the screen root, its units and pointer, and the pieces the game's screens share	✓
packages/genshin-mods	Claude Code plugin — eight mods, five under one band and three guards: next steps, cache and usage with a one-click handoff, recording mode, a goal meter, a collision guard, a delegation guard, a disk-scan guard and a whole-index guard	✓
packages/genshin-persona	Claude Code plugin — a Genshin character picked by birthday, replies spoken in its own cloned voice	✓
packages/genshin-text	The game's own text in its fifteen languages — the language registry, a locale matcher, and the game's strings by text id	✓
packages/genshin-world	Genshin's world on the engine — the region catalogue, each region's data, the TresJS components and the interface screens	✓
packages/headless-block-editor	A headless block editor: a typed node tree over a registry, the commands that edit it as JSON Patch operations, navigation and undo history, with no framework or DOM.	✓
packages/keyframe-store	Content-addressed version store — zstd keyframes and deltas over any backend	✓
packages/math-expression-compiler	Math expressions compiled once into a function of plain numbers — mathjs's numeric language, held to parity with its recorded answers	✓
packages/mjml-blocks	MJML's components as block types on the headless block editor — each component's attributes, defaults and nesting rules, a render to MJML's JSON form and source, and a read back from MJML, with no framework, DOM or MJML runtime.	✓
packages/nuxt-security-module	Nuxt security module for Nitro 3 and h3 2 — security headers, a nonce Content Security Policy, subresource integrity, CORS, basic auth, a rate limiter and a request size limit	✓
packages/parse-tmx	Parser for Tiled Map Editor .tmx files	✓
packages/pitch-transcription	The notes in a recording — Basic Pitch on ONNX Runtime, its readings turned into notes, bends and MIDI	✓
packages/shared	Shared TypeScript types, utilities, and error classes	✓
packages/shared-node	Node-only shared tooling — the machine-wide download cache, hidden-window child processes and benchmark reporting for vitest bench runs	✓
packages/tresjs-nuxt	TresJS for Nuxt — a Nuxt module that auto-imports the TresJS core API, registers TresCanvas for client and server, and registers every installed @tresjs package's components and composables, with no devtools UI of its own.	✓
packages/trpc-msw	tRPC for Mock Service Worker — every transport answered by tRPC's own handlers	✓
packages/trpc-nuxt-module	tRPC for Nuxt — a module registering the router's HTTP and WebSocket handlers, with composables over useAsyncData	✓
packages/vue-canvas-frame-headless	A headless canvas frame: an isolated document at a width, scaled down to fit a narrower pane, with its styles adopted into it, and no styling of its own.	✓
packages/vue-grid-layout-headless	A headless grid: the placement of items on a grid of cells, and the pointer gestures that move and resize them, with no styling.	✓
packages/vue-pdfjs-headless	Headless Vue composables over pdfjs-dist: a document's loading, a page's drawing and the viewer's state, with no styling and no renderer of its own.	✓
packages/vue-phaserjs	Phaser game engine integration for Vue	✓
scripts	The repository's own tooling — workspace graph, dependency report, sweep scans	—

🔌 Claude Code Plugins

This repository is also a Claude Code plugin marketplace named esposter, declared in .claude-plugin/marketplace.json. Anyone adds it by the repository's GitHub name and installs a plugin by its marketplace name:

claude plugin marketplace add Esposter/Esposter
claude plugin install genshin-persona@esposter
claude plugin install genshin-mods@esposter

Plugin	What it does
genshin-mods	Eight mods: five under one band above the prompt, waypoints (the next steps, one press each), resin (cache, context, limits and cost, with warm, compact and a one-click handoff), veil (recording mode), commission (a goal's task list and clock) and ward (a question before editing a file another session just changed), and three guards: a delegation guard that nudges a run of lookups toward a haiku agent, a disk-scan guard that refuses a Bash scan from a root or home folder, and a whole-index guard that refuses a git command over the whole index while another session shares the checkout.
genshin-persona	Speaks as the Genshin Impact character whose birthday is nearest to today, with each answer opening on a spoken line and the rest in plain prose, and reads each reply aloud in the character's own cloned voice.

A plugin here is an ordinary workspace package, so it is formatted, linted, tested and dependency-bumped with everything else, and a merge to main is its release: an installed copy follows the marketplace on the next plugin update. How that is built, and what it deliberately does not do, is on the Claude interface page.

🤝 Community

We welcome contributions from everyone and are committed to maintaining a friendly, safe, and welcoming community. Start with the Contributing guide, which also lists the recommended editor extensions. Please see our Code of Conduct and Security Policy for more information.

⚖️ License

This project is licensed under the Apache-2.0 license.