close
Skip to content

springgen-dev/springgen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SpringGen — Generate Production-Ready Spring Boot Projects in Minutes 🚀 npm License: MIT

from local development setup to production deployment foundation — Authentication, Database, Docker, CI/CD, and AWS EC2 deployment included.

👉 Try Starter via CLI • 🌐 Try All via Web UI


What is SpringGen?

Every new backend service starts the same way — same structure, auth setup, database config, security hardening, Docker, and CI/CD pipeline. Most developers rebuild this from scratch or copy-paste from a previous project every single time.

SpringGen is built around that repeated workflow. Whether you are a freelancer spinning up a new client backend, a founder building an MVP, or a developer starting another backend service — run the CLI or web UI, get a consistent production-ready backend, and start writing business logic.

No copy-pasting. No forgotten configs. No "how did I set this up last time."

SpringGen uses a deterministic template/module engine to assemble tested Spring Boot project structures, configurations, and production-ready components.


🧱 Generated Tech Stack

SpringGen generates modern Spring Boot applications using:

Backend

  • Java 21
  • Spring Boot 4
  • Gradle
  • Spring Data JPA / Hibernate
  • PostgreSQL / MySQL
  • MongoDB support (Starter)

Authentication & Security

  • Spring Security 7
  • JWT authentication scaffold (Starter)
  • OAuth2 login with Google & GitHub (Pro)
  • JWT access tokens & refresh tokens (Pro)
  • Security headers and production hardening (Pro)

API & Observability

  • Swagger / OpenAPI (Pro)
  • Request logging & observability (Pro)

DevOps & Deployment

  • Docker
  • Docker Compose
  • GitHub Actions CI (Starter)
  • GitHub Actions CI/CD deployment workflow (Pro)
  • AWS EC2 deployment automation (Pro)

🎥 Demo — Spring Boot + Docker + GitHub Actions + AWS EC2

See SpringGen generate and deploy a production-ready Spring Boot application in minutes.

SpringGen Demo

In this demo:

  • Generate a Spring Boot project ✅
  • Run locally with Docker Compose ✅
  • Configure GitHub Actions secrets ✅
  • Push code to trigger the CI/CD workflow ✅
  • Automatically deploy to AWS EC2 after successful build ✅
  • Verify production health endpoint ✅

For Part 2 : Spring Boot OAuth2 + JWT Access Tokens & Refresh Tokens in Minutes | SpringGen Part 2


How is SpringGen Different?

vs Spring Initializr

Spring Initializr gives you a project foundation — dependencies, build files, and a basic application entry point.

SpringGen starts where Initializr stops:

  • Layered architecture with controllers, services, repositories
  • DTO patterns and global exception handling
  • Database configuration
  • Authentication setup (JWT, OAuth2)
  • Production security configuration
  • Docker, CI/CD, and AWS deployment configuration

Initializr helps you start a Spring Boot project.

SpringGen helps you start a production-ready Spring Boot backend.

vs JHipster

JHipster is a full-stack generator — frontend, backend, and ongoing project management through its ecosystem. Powerful if you want a complete application platform with built-in conventions.

SpringGen generates a standard Spring Boot project and then gets out of the way:

  • No frontend opinions
  • No generator runtime dependencies
  • No custom framework APIs
  • No new ecosystem to learn

After generation, the code is yours — a normal Spring Boot application you can modify, deploy, and maintain however you want.

SpringGen sits between Initializr and JHipster:

More structure than Initializr. Less ecosystem commitment than JHipster.


Who is SpringGen For?

SpringGen is useful for developers who know Spring Boot but want to move faster.

Ideal for:

  • Backend developers building SaaS products
  • Freelancers starting new client projects
  • Startup founders creating MVP backends
  • Engineers building multiple backend services or APIs
  • Developers who want consistent project structure across projects
  • Java/Spring developers who prefer writing business logic over repeating setup

SpringGen may not be ideal for:

  • Developers looking for a Spring Boot learning tutorial
  • Teams with existing internal platform templates
  • Engineers who prefer manually configuring every project from scratch
  • Projects requiring highly customized enterprise architecture from day one

🚀 SpringGen Pro — Production Ready

Stop rebuilding the same production setup for every Spring Boot project.

SpringGen Pro unlocks unlimited Spring Boot backend generation — create as many projects as you need with authentication, database, security, deployment, and DevOps configuration ready to go.

Pay once. Generate unlimited production-ready Spring Boot projects.

⚙️ Interactive Project Generator UI

Choose:

  • Package name
  • Production Database (PostgreSQL, MySQL)
  • Docker setup
  • CI/CD
  • Authentication (OAuth2 + refresh tokens)
  • Logging
  • AWS deployment options

🔐 OAuth2 + Refresh Tokens

Generate production-ready Spring Security:

  • Google OAuth2 login
  • GitHub OAuth2 login
  • JWT access tokens
  • Refresh token flow
  • Persistent user storage
  • Persistent refresh tokens
  • Sample secured endpoints
  • Swagger API Testing

🐳 Production Docker Setup

Includes:

  • Dockerfile
  • docker-compose.yml
  • docker-compose.prod.yml
  • Environment configuration
  • Health checks

🚀 CI/CD → AWS EC2 Deploy

Push code.

GitHub Actions automatically:

  • Validates your application before deployment
  • Connects securely to EC2
  • Creates production configuration from GitHub Secrets
  • Runs the deployment script
  • Builds and deploys your Docker application

🖥️ Generated EC2 Deploy Script

Deploy anytime with a ready-to-use script.

Generated:

scripts/deploy-ec2.sh

Handles:

  • Docker builds
  • Application updates
  • Container cleanup
  • Restart policies
  • Resource limits

Use it through GitHub Actions or run manually on EC2.

🛡️ Security Hardening

Includes:

  • CORS configuration
  • Security headers
  • Request filtering
  • Stateless JWT authentication
  • Protected endpoints
  • Production-focused security structure

📊 Logging & Observability

Includes:

  • Request logging for API calls
  • Request ID tracing across application logs
  • Structured key=value console logs
  • Production-ready logging levels
  • Docker and cloud-friendly log output

AWS EC2 Deployment Automation

SpringGen EC2 Deployment

SpringGen Pro supports two deployment workflows:

Automated Deployment

GitHub Secrets
   ↓
Git Push
   ↓
GitHub Actions CI/CD Workflow
   ↓
Build + Test
   ↓
Deploy to EC2
   ↓
Docker Application Running

Best for production workflows.

Manual Deployment

Use the generated deploy script on EC2

# 1. One-time setup
nano .env.prod

# 2. Deploy anytime
git pull origin main
./scripts/deploy-ec2.sh

Best for manual releases, testing, and full control over deployments.


Unlock SpringGen Pro

Generate production-ready Spring Boot projects in minutes.

👉 https://app.springgen.dev

$29 one-time launch pricing

See more details : PRO-FEATURES.md


Starter vs Pro

Feature Starter Pro
Price Free $29 launch pricing
Spring Boot structure
Controller / Service / Repository layers
DTO structure
Global exception handling
JWT authentication scaffold
Database configuration
PostgreSQL / MySQL support
MongoDB support
Dockerfile
Docker Compose local setup
Basic GitHub Actions CI
OAuth2 authentication
Refresh token flow
Production configuration
AWS EC2 deployment automation
Full CI/CD deployment workflow
Logging and observability setup
Security hardening

Try SpringGen Free (Starter CLI)

The Starter edition is free and available through the CLI.

It is designed for:

  • Local development
  • MVP projects
  • Backend scaffolding
  • Learning project structure
  • Quickly starting Spring Boot APIs

Install

npm install -g springgen

Generate a Project

springgen init my-app --db=postgres

Supported Databases (Starter)

--db=postgres
--db=mysql
--db=mongo
--db=none

Run the Generated Project

Configure your environment — update .env values before running.

cd my-app
./gradlew bootRun

Or run with Docker:

docker compose up --build

The application starts at:

http://localhost:8080

How It Works

CLI or UI sends project configuration
↓
SpringGen backend validates requested tier
↓
Generator engine builds project dynamically
↓
Starter or Pro modules are applied
↓
ZIP project is generated
↓
User downloads and runs the project

Example Generated Project Structure

my-app/
├── src/main/java/com/example/
│   ├── controller/
│   ├── service/
│   ├── repository/
│   ├── dto/
│   ├── entity/
│   ├── config/
│   ├── security/
│   ├── filter/
│   ├── exception/
│   └── Application.java
│
├── src/main/resources/
│   ├── application.yml
│   └── application-prod.yml          # Pro
│
├── Dockerfile
├── docker-compose.yml
├── docker-compose.prod.yml           # Pro
│
├── .github/workflows/
│   ├── ci.yml                        # Starter
│   └── ci-cd.yml                     # Pro
│
├── scripts/
│   └── deploy-ec2.sh                 # Pro
│
├── .env
└── .env.prod                         # Pro

Screenshots

Generate Starter Projects

Starter Generator

Generate free Spring Boot Starter projects with:

  • JWT scaffold
  • Docker setup
  • Database configuration
  • Basic CI

Generate Pro Projects

Pro Generator

Generate production-ready Spring Boot projects with:

  • OAuth2 authentication
  • Refresh tokens
  • AWS deployment automation
  • CI/CD
  • Security hardening

Starter Generated Output

Starter Output


Pro Generated Output

Pro Output


Authentication Notes

Starter includes a lightweight JWT scaffold for development and demonstration purposes.

Pro includes production-focused authentication support with:

  • OAuth2 login
  • JWT access tokens
  • Refresh tokens
  • Persistent user and token entities

For more details, see:

docs/JWT-SCAFFOLD.md
docs/PRO-FEATURES.md

Documentation

Available documentation:

docs/
├── CLI-USAGE.md
├── STARTER-JWT-SCAFFOLD.md
├── STARTER-DOCKER-SETUP.md
├── PRO-FEATURES.md
└── FAQ.md

Pro Documentation

SpringGen Pro generated projects include additional production guides:

  • AWS EC2 deployment guide
  • OAuth2 + refresh token setup
  • Production configuration guide
  • CI/CD deployment instructions

Available inside generated Pro projects.


📚 Articles & Guides

Technical deep dives behind the problems SpringGen helps automate:


Examples

Example resources:

examples/
├── screenshots/
│
│   # UI
│   ├── starter-generator-ui.png
│   ├── pro-generator-ui.png
│
│   # Generated outputs
│   ├── generated-starter-project.png
│   └── generated-pro-project.png
│
└── generated-structure.md

SpringGen Editions

SpringGen provides a free Starter generator and a paid Pro upgrade.

  • Starter is free.
  • Pro is a one-time purchase.
  • SpringGen does not provide consulting, freelancing, or custom software development services.
  • Pro access unlocks premade automated project generation features.

🗺 Roadmap

Planned future improvements:

Developer Experience

  • IntelliJ IDEA plugin
  • More project customization options
  • Additional Spring Boot modules

Infrastructure & Deployment

Improvements planned for existing generation workflows:

  • AWS CloudFormation support
  • Additional deployment templates

Future Team & Scale Tiers

Planned capabilities for larger projects and teams:

  • Multi-module workspace generator
  • API Gateway service generation
  • Shared infrastructure templates
  • Multi-environment support (dev/staging/prod)
  • Database migrations with Flyway
  • Terraform infrastructure generation
  • Amazon ECS deployment support
  • Advanced CI/CD strategies
  • Advanced monitoring and observability integrations

Support

For support,

contact: 📧 support@springgen.dev

Website: 🌐 https://app.springgen.dev


Repository Scope

This public repository contains SpringGen documentation, examples, screenshots, and preview versions of the Starter CLI/npm client.

The preview CLI projects are provided for transparency and local exploration.

The production SpringGen backend, web application, billing integration, deployment infrastructure, Pro templates, and commercial generation modules are maintained privately.

The published npm package and hosted SpringGen platform are operated from the private production repository.


License

The public SpringGen documentation, examples, and preview CLI clients are released under the MIT License.

SpringGen Pro templates, premium modules, deployment infrastructure, backend services, and commercial generation features are proprietary and are not included under this license.

See:

LICENSE


⭐ Support the Project

If this helped you:

  • Star this repo
  • Share with other developers

One-Line Summary

Generate Spring Boot backends instantly — from local setup to production deployment foundations.

Contributors