Development Setup

Prerequisites

• JDK 21+
• Node.js 20+
• Docker (for PostgreSQL)

Setup

git clone https://github.com/plugwerk/plugwerk.git
cd plugwerk
docker compose up -d postgres
./gradlew build

Running the Server

./gradlew :plugwerk-server:plugwerk-server-backend:bootRun

The server starts at http://localhost:8080.

Frontend Development

cd plugwerk-server/plugwerk-server-frontend
npm install
npm run dev

Vite dev server runs at http://localhost:5173 and proxies API requests to the backend.

Running Tests

# Backend (all modules)
./gradlew build

# Frontend
cd plugwerk-server/plugwerk-server-frontend
npm run test:run

Code Style

Language	Check	Fix
Kotlin	./gradlew spotlessCheck	./gradlew spotlessApply
TypeScript	npm run lint	npm run lint -- --fix

Always run the formatter before committing.