⚠️ AlabJS is under active development and not yet production-ready. APIs may change before v1.0. Feel free to explore, contribute, or star the repo.
Skip to content

AlabJS runs on any Node.js ≥ 22 server with no cloud-specific dependencies.

Build

bash
pnpm build

This compiles TypeScript with the Rust compiler, bundles the client with Vite, and outputs to .alabjs/dist/.

Start

bash
pnpm start
# or directly:
PORT=8080 node node_modules/.bin/alab start

Environment variables

VariableDefaultDescription
PORT3000HTTP port
HOST0.0.0.0Bind address
NODE_ENVdevelopmentSet to production in prod
PUBLIC_URLPublic base URL (for sitemap + CSRF)

Docker

dockerfile
FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["node", "node_modules/.bin/alab", "start"]

PM2

bash
pm2 start "node node_modules/.bin/alab start" --name my-alabjs-app
pm2 save
pm2 startup

Released under the MIT License.