Skip to content

Enterprise-Grade Full-Stack Starter Kit – Spring Boot & Angular A powerful starter kit with JWT authentication, Flyway migrations, built-in route protection, and a CLI for quick setup.

License

Notifications You must be signed in to change notification settings

nathangtg/jangular-cli

Repository files navigation

JAngular CLI

Enterprise-grade full-stack scaffolding for Angular + Spring Boot applications

npm version npm downloads license

Rapidly bootstrap production-ready full-stack applications with Angular 17+ frontend and Spring Boot 3 (Java 21) backend. Includes JWT authentication, multi-database support, Docker integration, and enterprise security out of the box.

Features

  • 🚀 Quick Setup - Generate complete full-stack projects in minutes
  • 🔐 Built-in Auth - JWT authentication with refresh tokens and session management
  • 🗄️ Multi-Database - Support for MySQL, PostgreSQL, and MSSQL
  • 🐳 Docker Ready - Pre-configured containerization with docker-compose
  • 🎨 Modern Stack - Angular 17+ with standalone components and Tailwind CSS
  • Spring Boot 3 - Java 21 with Spring Security and Flyway migrations
  • 📊 User Management - Complete admin dashboard with role-based access control

Installation

npm install -g jangular-cli

Quick Start

# Create a new project jangular init my-app # Navigate to project cd my-app # Install dependencies npm run install:all # Start development servers npm run start:backend # Spring Boot on :8080 npm run start:frontend # Angular on :4200

Visit http://localhost:4200 to see your application.

Requirements

  • Node.js ≥ 18
  • Java ≥ 21
  • Maven 3.x
  • Docker (optional)

Check if your system meets requirements:

npx jangular --test

CLI Commands

Initialize Project

jangular init <project-name> [options] Options: -g, --group-id <groupId> Java group ID (default: com.example) -a, --artifact-id <id> Java artifact ID (default: backend)

Docker Management

jangular docker

Interactive menu to manage Docker services, view logs, and check health status.

Build Project

jangular build [options] Options: -b, --backend Build backend only -f, --frontend Build frontend only -p, --prod Production build

Run Tests

jangular test [options] Options: -b, --backend Test backend only -f, --frontend Test frontend only

Project Structure

my-app/ ├── backend/ # Spring Boot application │ ├── src/ │ ├── pom.xml │ └── Dockerfile ├── frontend/ # Angular application │ ├── src/ │ ├── package.json │ └── Dockerfile ├── docker-compose.yml # Container orchestration └── package.json # Root scripts 

What's Included

Backend (Spring Boot)

  • JWT authentication & authorization
  • User management with CRUD operations
  • Role-based access control (RBAC)
  • Account lockout and password policies
  • Session tracking and login history
  • Flyway database migrations
  • Global exception handling
  • RESTful API architecture

Frontend (Angular)

  • Standalone components architecture
  • Pre-built auth UI (login, register, reset password)
  • User management dashboard
  • HTTP interceptors for token handling
  • Route guards for protected pages
  • Reactive forms with validation
  • Tailwind CSS styling
  • Responsive design

DevOps

  • Multi-container Docker setup
  • Development and production profiles
  • Database GUI tools (phpMyAdmin/pgAdmin)
  • Health check endpoints
  • Volume persistence configuration

Documentation

Full documentation available at jangular.nathangtg.com

Contributing

Contributions welcome! Please see our Contributing Guide.

License

MIT © nathangtg

Links


JAngular CLI - Enterprise application development simplified