Skip to content

Releases: nathangtg/jangular-cli

Jangular CLI v2.0.1 - Documentation and Major Changes

Choose a tag to compare

@nathangtg nathangtg released this 09 Oct 15:03

Changelog

All notable changes to this project will be documented in this file.

This project adheres to Semantic Versioning.

[2.0.1]

🎉 Major Release

JAngular CLI v2.0.0 represents a significant milestone with major improvements to documentation, user experience, and feature completeness.

✨ Added

Documentation

  • Modern Documentation Site - Brand new documentation website built with Next.js 15.5.4
  • Professional UI Design - Clean, modern interface with Java Orange and Angular Red theme
  • Responsive Layout - Mobile-first design that works seamlessly across all devices
  • Interactive Navigation - Sidebar navigation with SVG icons for easy access to all sections
  • Comprehensive Guides - Detailed guides for getting started, CLI commands, backend, frontend, Docker, and deployment
  • FAQ Section - Answers to common questions and troubleshooting tips

CLI Features

  • Interactive Docker Management - New jangular docker command for managing Docker services
  • System Requirements Check - jangular --test command to verify all dependencies
  • Enhanced Progress Indicators - Real-time feedback with Ora spinners during project generation
  • Better Error Messages - Clear, actionable error messages with recovery suggestions
  • Input Validation - Comprehensive validation for all user inputs during project initialization

Backend Features

  • Advanced Security Features
    • Account lockout after failed login attempts
    • Password history tracking to prevent reuse
    • Enhanced password policies
    • CSRF protection
  • User Management Enhancements
    • Active session tracking and management
    • Comprehensive login history with IP address and device tracking
    • User search and filtering capabilities
    • Bulk operations support
  • API Improvements
    • Enhanced error responses with detailed messages
    • Improved validation for DTOs
    • Better exception handling with global error handler
    • Health check endpoints for monitoring

Frontend Features

  • Standalone Components - Migrated to modern Angular standalone architecture
  • Enhanced UI Components
    • User management dashboard with data tables
    • Active sessions viewer
    • Login history viewer
    • Improved authentication forms with better validation feedback
  • Responsive Design - Mobile-optimized components with Tailwind CSS
  • Better State Management - Improved service architecture for state handling
  • Enhanced Guards - More robust authentication and authorization guards

🔄 Changed

  • Package Metadata - Updated package.json with comprehensive metadata for NPM publishing
  • Documentation Structure - Reorganized documentation for better discoverability
  • Error Handling - Improved error handling throughout the CLI
  • Template Structure - Enhanced project templates with better organization
  • Dependencies - Updated all dependencies to latest stable versions
    • Next.js 15.5.4
    • React 19.1.0
    • TailwindCSS v4
    • Spring Boot 3.4.3
    • Angular 17+

🐛 Fixed

  • Hydration Errors - Resolved Next.js SSR hydration mismatches in sidebar component
  • Code Block Display - Fixed project structure displays showing as single horizontal lines
  • Overflow Issues - Fixed horizontal scrolling issues in documentation pages
  • CSS Specificity - Resolved Tailwind prose style conflicts with high-specificity rules
  • Mobile Menu - Fixed mobile navigation menu behavior
  • Token Refresh - Improved JWT token refresh mechanism

🎨 Improved

  • Code Quality - Enhanced code organization and maintainability
  • Performance - Optimized project generation speed
  • User Experience - Simplified workflows and reduced friction
  • Accessibility - Improved keyboard navigation and screen reader support
  • Visual Design - Removed emojis for a more professional appearance
  • Typography - Better font choices and spacing throughout documentation

📚 Documentation

  • README.md - Complete rewrite with professional formatting, badges, and comprehensive sections
  • Installation Guide - Step-by-step instructions with verification steps
  • CLI Reference - Detailed documentation for all commands with examples
  • API Documentation - Complete API endpoint reference with request/response examples
  • Docker Guide - Comprehensive Docker deployment guide with best practices
  • Contributing Guide - Clear contribution guidelines

🔐 Security

  • Enhanced Authentication - Improved JWT token handling and validation
  • Password Policies - Stronger password requirements and history tracking
  • Account Lockout - Protection against brute force attacks
  • Session Security - Better session management and tracking
  • CSRF Protection - Enhanced cross-site request forgery protection

🚀 Performance

  • Faster Generation - Optimized template copying and processing
  • Reduced Bundle Size - Minified assets and code splitting in Angular
  • Lazy Loading - Improved lazy loading strategy for Angular modules
  • Database Queries - Optimized JPA queries and indexing

🛠️ Development

  • Better Tooling - Enhanced development scripts and workflows
  • Testing - Improved test coverage (target: 80%+)
  • Linting - Updated ESLint configuration with stricter rules
  • Build Process - Optimized build and deployment pipeline

📦 Package

  • NPM Publishing - Prepared package for public NPM registry
  • Files Array - Specified files to include in the package
  • Publish Config - Added publish configuration for public access
  • Engines - Specified Node.js and npm version requirements
  • Keywords - Expanded keywords for better discoverability
  • GitHub Packages - GitHub Package publishing

What's Changed

Full Changelog: v1.3.0...v2.0.0

Full Changelog: v2.0.0...v2.0.1

JAngular v1.3.0 - Docker Infrastructure Update and CLI Enhancement

Choose a tag to compare

@nathangtg nathangtg released this 30 Apr 17:09

JAngular v1.3.0 - Docker Infrastructure Update and CLI Enhancement

🚀 Overview

We're excited to announce the release of JAngular v1.3.0! This version introduces comprehensive Docker support with pre-configured services, making it easier than ever to set up your development environment and deploy your applications.

✨ New Features

Docker Integration

  • Ready-to-use Docker configuration - No need to start from scratch! Use our pre-configured Docker setup for your JAngular applications
  • Interactive CLI commands - Manage your Docker services with simple npx jangular docker commands
  • Multi-container architecture - Complete development stack with frontend, backend, and database services

Container Services

  • Spring Boot Backend - Java 21 container with Maven build system
  • Angular Frontend - Node.js 20 build environment with Nginx server
  • Database Services:
    • MySQL 8.0 with phpMyAdmin interface
    • PostgreSQL 15 with pgAdmin interface
  • Health checks and container dependency management for reliable startup
  • Persistent volumes for database data preservation

Developer Experience

  • Interactive Docker management menu with the following options:
    • Start all services
    • Start only databases
    • Start backend only
    • Start frontend only
    • Show running containers
    • View service logs with selection interface
    • Check database health
    • Stop all services
    • Reset volumes (with confirmation)
  • Colored output in terminal for better readability
  • Automatic verification of Docker dependencies
  • Service access information displayed automatically

🛠️ Technical Details

Service Endpoints

Service URL Credentials
Backend http://localhost:8080 -
Frontend http://localhost:4200 -
phpMyAdmin http://localhost:8081 root / rootpassword
pgAdmin http://localhost:8082 admin@admin.com / admin

Docker Files Added

  • docker-compose.yml - Main configuration file for all services
  • backend.Dockerfile - Multi-stage build for the Spring Boot application
  • frontend.Dockerfile - Multi-stage build for the Angular application

📋 Usage

Prerequisites

  • Docker
  • Docker Compose

Quick Start

# Start the interactive Docker menu
npx jangular docker

Or directly start all services

npx jangular docker start-all

Available Commands

npx jangular docker             # Open interactive menu
npx jangular docker start-all   # Start all containers
npx jangular docker start-db    # Start only database containers
npx jangular docker ps          # Show running containers
npx jangular docker logs        # View container logs
npx jangular docker health      # Check database health
npx jangular docker stop        # Stop all containers
npx jangular docker reset       # Reset all data volumes

📝 Notes

  • All database data is persisted in Docker volumes
  • Services are configured to restart automatically unless explicitly stopped
  • The backend service waits for databases to be healthy before starting

🔄 Upgrading from Previous Versions

If you're upgrading from a previous version, you can simply run:

npm update -g jangular
# or
npx jangular update

After updating, you'll have immediate access to the new Docker functionality.

🧪 Known Issues & Limitations

  • Docker commands require Docker and Docker Compose to be installed and running
  • The Docker menu currently only supports one configuration at a time
  • Custom environment variable configuration will be added in a future release

We hope this update makes your development workflow smoother! If you encounter any issues or have suggestions, please open an issue on our GitHub repository.

Jangular v1.2.0

Choose a tag to compare

@nathangtg nathangtg released this 18 Mar 10:51

Jangular v1.2.0 - Enterprise Angular & Spring Boot Toolkit

A powerful CLI tool for rapidly bootstrapping full-stack applications with Angular 17 & Spring Boot (Java 21), featuring integrated security, services, and enterprise-ready components.

🚀 What's New in v1.2.0

  • ✅ Automated Environment Verification - Checks Java, Angular, Maven, and Node versions
  • 👥 Complete Admin Dashboard - Comprehensive user management system
  • 🔒 Refined Access Control - New Admin Guard alongside existing Auth Guard
  • 🔧 Critical Bug Fixes - Resolved auth guard registration page access issue
  • 📚 Better Documentation - Route tables for improved readability
  • 📄 MIT License - Updated from ISC with added LICENSE.txt

📊 Stats & Info

Version Downloads (7 Days) Published Tag
1.2.0 3,936 Just released latest
1.1.1 6,322 5 days ago -
1.0.2 67 6 days ago -
1.0.1 60 6 days ago -
1.0.0 69 6 days ago -

🔧 Core Technology Stack

  • Frontend: Angular 17
  • Backend: Spring Boot (Java 21)
  • Security: Spring Security
  • Tools: Node.js, npm

📋 Requirements

  • Node.js ≥18
  • Java ≥21

🏷️ Keywords

angular spring-boot starter-kit enterprise development cli automation java typescript fullstack authentication security

👤 Author

Nathan G. - GitHub Profile


Jangular - Accelerating Enterprise Application Development

Stats as of March 18, 2025

Official First Release

Choose a tag to compare

@nathangtg nathangtg released this 13 Mar 13:25

Jangular v1.1.1 - Official Release

Version Downloads

🚀 Enterprise-Grade Java API & Angular Starter Kit

Jangular is a comprehensive starter kit that combines the power of Spring Boot for backend development and Angular for frontend, with built-in authentication and authorization systems. This project aims to accelerate enterprise-level development by providing a robust foundation for creating secure, scalable applications.

✨ Features

  • Full-Stack Solution: Seamlessly integrates Spring Boot backend with Angular frontend
  • Authentication & Authorization: Pre-configured security using Spring Security and JWT tokens
  • Database Flexibility: Support for MySQL, PostgreSQL, and MSSQL databases
  • Database Integration: Database support with JPA/Hibernate
  • Database Migration: Automated database schema management with Flyway
  • CLI Tool: Simple command-line interface for project initialization
  • Ready-to-Use Components: Login, registration, and dashboard components
  • Route Protection: Built-in authentication guards for securing routes
  • Token Management: HTTP interceptors for automatic token handling
  • Service Architecture: Well-structured service layer for API communication

🛠️ Technologies

Backend

  • Java 21
  • Spring Boot 3.4.3
  • Spring Security
  • Spring Data JPA
  • JWT Authentication
  • Flyway Migration
  • MySQL, PostgreSQL, or MSSQL support
  • Lombok
  • Maven

Frontend

  • Angular (latest version)
  • TypeScript
  • Angular Material
  • RxJS
  • Lazy-loaded modules
  • Route Guards
  • HTTP Interceptors
  • Reactive Forms

CLI Tool

  • Node.js
  • Commander.js
  • Inquirer.js
  • Chalk
  • fs-extra

🚀 Getting Started

Installation

# Install the Jangular CLI
npm install jangular-cli

Create a new Jangular project

npx jangular-cli init my-project

Navigate to your project

cd my-project

Start the backend

npm run start:backend

In another terminal, start the frontend

npm run start:frontend

📦 NPM Version History

Version Downloads (Last 7 Days) Published
1.1.1 10+ Latest
1.0.2 552 21 hours ago
1.0.1 532 21 hours ago
1.0.0 62 2 days ago

🔄 What's New in v1.1.1

This marks the first official release on GitHub! Jangular is now ready for enterprise-level application development with comprehensive documentation and a stable API.

🔗 Links

📝 License

This project is licensed under the ISC License - see the LICENSE file for details.


Jangular - Accelerating Enterprise Application Development

# Jangular v1.1.1 - Official Release

Version
Downloads

🚀 Enterprise-Grade Java API & Angular Starter Kit

Jangular is a comprehensive starter kit that combines the power of Spring Boot for backend development and Angular for frontend, with built-in authentication and authorization systems. This project aims to accelerate enterprise-level development by providing a robust foundation for creating secure, scalable applications.

✨ Features

  • Full-Stack Solution: Seamlessly integrates Spring Boot backend with Angular frontend
  • Authentication & Authorization: Pre-configured security using Spring Security and JWT tokens
  • Database Flexibility: Support for MySQL, PostgreSQL, and MSSQL databases
  • Database Integration: Database support with JPA/Hibernate
  • Database Migration: Automated database schema management with Flyway
  • CLI Tool: Simple command-line interface for project initialization
  • Ready-to-Use Components: Login, registration, and dashboard components
  • Route Protection: Built-in authentication guards for securing routes
  • Token Management: HTTP interceptors for automatic token handling
  • Service Architecture: Well-structured service layer for API communication

🛠️ Technologies

Backend

  • Java 21
  • Spring Boot 3.4.3
  • Spring Security
  • Spring Data JPA
  • JWT Authentication
  • Flyway Migration
  • MySQL, PostgreSQL, or MSSQL support
  • Lombok
  • Maven

Frontend

  • Angular (latest version)
  • TypeScript
  • Angular Material
  • RxJS
  • Lazy-loaded modules
  • Route Guards
  • HTTP Interceptors
  • Reactive Forms

CLI Tool

  • Node.js
  • Commander.js
  • Inquirer.js
  • Chalk
  • fs-extra

🚀 Getting Started

Installation

# Install the Jangular CLI
npm install jangular-cli

# Create a new Jangular project
npx jangular-cli init my-project

# Navigate to your project
cd my-project

# Start the backend
npm run start:backend

# In another terminal, start the frontend
npm run start:frontend

📦 NPM Version History

Version Downloads (Last 7 Days) Published
1.1.1 10+ Latest
1.0.2 552 21 hours ago
1.0.1 532 21 hours ago
1.0.0 62 2 days ago

🔄 What's New in v1.1.1

This marks the first official release on GitHub! Jangular is now ready for enterprise-level application development with comprehensive documentation and a stable API.

🔗 Links

📝 License

This project is licensed under the ISC License - see the LICENSE file for details.


Jangular - Accelerating Enterprise Application Development