mcpField
S
spring-boot-full-stack

spring-boot-full-stack

github.com/mduongvandinhDevelopment6147 installsUpdated 44w ago
Repository

About spring-boot-full-stack

spring-boot-full-stack is a modular skill for Java developers building Spring Boot applications, covering practices such as testing, error handling, and validation. Modules for PostgreSQL, Redis, messaging, and OAuth2 can be enabled as needed, alongside a spec-first and TDD workflow.

Key features

  1. 01Select modules through Maven configuration
  2. 02Support PostgreSQL, Redis, and messaging
  3. 03Include error handling, validation, and logging skills
  4. 04Provide unit and integration testing practices
  5. 05Use spec-first development and TDD

Use cases

  1. 01Initialize a modular Spring Boot project
  2. 02Add caching or messaging components as needed
  3. 03Apply test-driven development to an application
  4. 04Start development infrastructure with Docker

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mduongvandinh/skills-java-spring --skill spring-boot-full-stack

After installing, type/spring-boot-full-stackin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.continuerc.json
.cursorrules
.gitignore
.windsurfrules
AGENTS.md
CLAUDE.md
docker-compose.yml
Dockerfile
Makefile
pom.xml
QUICKSTART.md
README.md
.github/
copilot-instructions.md
openspec/
AGENTS.md
README.md
openspec/changes/example-user-registration/
proposal.md
tasks.md
openspec/changes/example-user-registration/specs/auth/
registration.md
openspec/specs/api/
rest.md
openspec/specs/architecture/
layers.md
openspec/specs/testing/
tdd.md
scripts/
start-local.ps1
start-local.sh
src/main/java/com/company/app/
Application.java
src/main/java/com/company/app/config/
ConditionalOnModuleEnabled.java
ModuleProperties.java
SecurityConfig.java
src/main/java/com/company/app/controller/
HealthController.java
ModuleController.java
SystemController.java

Details

From the project README

Spring Boot Full Stack Skill

Overview

This skill provides a complete, modular framework for building Java Spring Boot applications with enterprise-grade features.

Quick Start

# Minimal setup (PostgreSQL + JWT only)
mvn clean install -Pminimal

# With Redis caching
mvn clean install -Dmodule.redis.enabled=true

# Full stack (all modules)
mvn clean install -Pfull-stack

# Run application
mvn spring-boot:run -Dspring-boot.run.profiles=local

Module Selection

ModuleDefaultEnable Flag
PostgreSQLON-Dmodule.postgresql.enabled=true
RedisOFF-Dmodule.redis.enabled=true
KafkaOFF-Dmodule.kafka.enabled=true
RabbitMQOFF-Dmodule.rabbitmq.enabled=true
OAuth2OFF-Dmodule.oauth2.enabled=true

Development Workflow

  1. Spec First: Define specifications in openspec/specs/
  2. TDD: Write tests first (RED)
  3. Implement: Write minimal code (GREEN)
  4. Refactor: Improve code quality
  5. Archive: Update specs after implementation

Docker Options

# Without Docker (services installed locally)
make dev

# With Docker infrastructure
make dev-docker

# Full Docker deployment
docker compose --profile with-app up -d

Skills Included

Core (Always enabled)
  • spring-project-init - Project initialization
  • spring-maven-modular - Maven profiles & BOM
  • spring-error-handling - Global exception handling
  • spring-validation - Request validation
  • spring-logging - Structured logging
  • spring-testing - Unit + Integration testing
  • spring-tdd-mockito - TDD with Mockito
  • spring-openspec - Spec-First Development
Optional
  • spring-redis - Redis caching
  • spring-kafka - Kafka messaging
  • spring-rabbitmq - RabbitMQ messaging
  • spring-oauth2 - OAuth2/OIDC
  • spring-rbac - Role-based access control
  • spring-docker - Docker containerization
  • spring-api-docs - OpenAPI/Swagger
  • spring-monitoring - Actuator + Prometheus

File Structure

src/
├── main/
│   ├── java/
│   │   └── com/company/app/
│   │       ├── config/           # Configuration classes
│   │       ├── controller/       # REST controllers
│   │       ├── service/          # Business logic
│   │       ├── repository/       # Data access
│   │       ├── domain/           # Entities
│   │       ├── dto/              # Data transfer objects
│   │       ├── exception/        # Custom exceptions
│   │       └── security/         # Security configuration
│   └── resources/
│       ├── application.yml
│       ├── application-local.yml
│       ├── application-dev.yml
│       ├── application-prod.yml
│       └── db/migration/         # Flyway migrations
├── test/
│   └── java/
│       └── com/company/app/
│           ├── unit/             # Unit tests
│           └── integration/      # Integration tests
└── openspec/
    ├── AGENTS.md
    ├── specs/                    # Feature specifications
    └── changes/                  # Proposed changes

References

Comments

Markdown supported