Loomify

A production-ready SaaS starter template and monorepo for building subscription web apps (backend: Spring Boot + Kotlin, frontend: Vite/Astro/Vue).

Badges

Quick overview

• Monorepo: frontend apps in client/, backend services in server/, shared Kotlin libs in shared/.
• Backend: Spring Boot (Kotlin), R2DBC, Liquibase, Testcontainers.
• Frontend: Vite + Vue 3, Astro landing, Tailwind CSS, PNPM workspaces.

Quickstart (developer)

Requirements: JDK 21+, pnpm >= 10, Docker & Docker Compose, Git

Install JS deps and build:

pnpm install

Start local infra (optional):

docker compose up -d postgresql keycloak greenmail

Run backend (development):

./gradlew :server:engine:bootRun

Run frontend dev (example):

pnpm --filter @loomify/webapp dev

Run all tests (frontend + backend):

pnpm test
./gradlew test

Project structure (high level)

See these folders at the repository root:

• client/ — frontend apps and shared TS packages
• server/ — Kotlin/Spring Boot services
• shared/ — shared Kotlin libraries
• infra/ — docker compose and helper scripts

Contributing

We follow Conventional Commits. See CONTRIBUTING.md and the .ruler/ docs for repo conventions. Pre-commit hooks are installed by lefthook in the prepare script.

If you open a PR, ensure the CI passes (lint, tests, detekt) and keep PRs small and focused.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Authors

• @yacosta738 (repo owner and maintainer)

Further reading

• For module-level docs and quickstarts see the docs/src/content/docs and .ruler/ directories.