Skip to content

Repository files navigation

✈️ Tripr

Modern SaaS Starter combining the power of Spring Boot 4 (Kotlin) and the reactivity of Angular 21 (Signals).

Build StatusKotlinAngularLicense

Tripr is a production-ready template designed for scalability, security, and a smooth developer experience. It features a contract-first approach using OpenAPI to bridge the gap between a strict Hexagonal backend and a reactive Zoneless frontend.

🏗️ Architecture Overview

graph LR
subgraph Angular
A1[Components]
A2[Services]
end
subgraph OpenAPI-Generator
O1[openapi.yaml]
O2[TS Client]
end
subgraph Spring-Boot
subgraph adapters-in
B1[REST Controllers]
end
subgraph domain
B2[Ports In]
B3[Services / Use Cases]
B4[Ports Out]
end
subgraph adapters-out
B5[Persistence JPA]
B6[Notification Email]
end
subgraph application
B7[Main / Config]
end
B1 --> B2 --> B3 --> B4
B4 --> B5
B4 --> B6
end
A2 --> O1 --> O2 --> B1
Loading

🛠️ Tech Stack

ComponentKey Technologies
BackendKotlin, Spring Boot 4.+, Spring Security (JWT), Liquibase, MapStruct, Testcontainers
FrontendAngular 21, Vite, Vitest, Bootstrap 5, Transloco (i18n), Signals, Zoneless
BridgeOpenAPI Generator (Automatic Model & API Synchronization)
DevOpsDocker, GitHub Actions, Ansible

🚀 Quick Start

1. Prerequisites

  • Java 25+
  • Node.js 24+ (npm 11+)
  • Docker & Docker Compose

2. Run the project

Thanks to Spring Boot Docker Compose support, the PostgreSQL database is managed automatically when the backend starts.

# Terminal 1: Backendcd backend && ./gradlew bootRun
# Terminal 2: Frontendcd frontend && npm install && npm run dev

📁 Monorepo Structure

.
├── api-spec/ # OpenAPI Specifications (API Contract)
├── backend/ # Spring Boot Kotlin API (Hexagonal Structure)
├── devops/ # Docker, Ansible & CI/CD configurations
├── e2e/ # End-to-end tests with Cypress
└── frontend/ # Angular Application (Vite & Standalone)

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages