WEB + Encore.ts Monorepo

This repository is a template workspace with three main parts:

• apps/web - Next.js frontend
• apps/services - Encore.ts backend services
• shared/* - Shared code and types for both frontend and backend

Documentation

This root README is only a workspace index. Detailed guides are split by app:

• Frontend and gateway workflow: apps/web/README.md
• Backend services and Encore usage: apps/services/README.md

Start Initial App

To get started, follow the instructions in apps/services/README.md to run the initial Encore service, then follow apps/web/README.md to run the frontend and APISIX gateway. or use this quick start:

1. Install dependencies:

pnpm install

2. Init Encore app:

cd apps/services
encore app init services --lang typescript

Local Development Topology

• Enter via APISIX at http://localhost:9080
• APISIX routes web traffic to Next.js (localhost:3000)
• APISIX routes /api/* to Encore (localhost:4000) and rewrites to Encore paths

To start APISIX:

cd apps/router
docker compose up -d

auto-starts

pnpm dev

stop APISIX:

cd apps/router
# docker compose down # Uncomment to stop APISIX when done
docker compose stop # Stops APISIX without removing containers, allowing for quick restart

Then run web and services apps in development mode.