Esposter

• 📖 Documentation
• 🏠 Local Development
• 🧱 Architecture
• 📦 Packages
• 🤝 Community
• ⚖️ License

We highly recommend you take a look at the documentation to level up.

	Nuxt The Intuitive Web Framework, based on Vue.
	Vue 🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
	Vuetify 🐉 Material Component Framework for Vue.
	Pinia 🍍 Intuitive, type safe, light and flexible Store for Vue using the composition api with DevTools support.

	tRPC 🧙‍♀️ Move Fast and Break Nothing. End-to-end typesafe APIs made easy.
	Zod TypeScript-first schema validation with static type inference.
	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.

	Pulumi Infrastructure as Code in any programming language.

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

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

1. Install Node Modules:

pnpm i

2. Install PostgreSQL + PgAdmin.

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

Checkout the deployment documentation for more information.

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

pnpm build:packages

2. Change to the app directory:

cd apps/web

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

pnpm dev

Build the application for production:

pnpm build

Locally preview production build:

pnpm preview

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:*.

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

Three branches, each written by exactly one actor, turn a stream of AI-authored commits into reviewed releases without anyone waiting on anyone. Sessions push to ai/queue as fast as they commit. The review collector — a GitHub Actions workflow fired by every ai/queue push and every CodeRabbit review — drains the open findings, ports the largest green window under CodeRabbit's file cap onto develop, and replies on each thread with the pushed sha. develop merges to main once a window comes back clean, and the push to main runs the same collector, which fast-forwards develop back onto it. A window is budgeted in files and spent on findings, so the collector proves which commits have nothing in them to comment on — every file a 100% rename or an import specifier following one — and sends those straight to main rather than letting a folder sweep occupy a window it will return nothing from. The design and its fine print live in the review collector docs.

flowchart LR
  S[AI sessions<br/>commit continuously] -->|git push| Q[(ai/queue)]
  Q -->|push event| C{{Review collector<br/>gates, drains, ports}}
  C -->|largest green window<br/>under the cap| D[(develop)]
  C -->|express: provably<br/>nothing to review| M
  D -->|pull request synchronized| R[CodeRabbit review<br/>one slot per hour]
  R -->|review submitted| C
  C -->|fixes parked| F[(ai/review-fixes)]
  F -->|lead the next window| D
  D -->|zero findings| M[(main)]
  M -->|push event| C
  C -->|fast-forward after the merge<br/>fold a bump into the next window| D

We welcome contributions from everyone and are committed to maintaining a friendly, safe, and welcoming community. Please see our Code of Conduct and Security Policy for more information.

This project is licensed under the Apache-2.0 license.