jhipster-forge
First dedicated Claude Code plugin for JHipster 8.x. Generate entities, DTOs, JDL domain models, Spring services and controllers directly fr
Open source Open in the app JSON README (API)
About
First dedicated Claude Code plugin for JHipster 8.x. Generate entities, DTOs, JDL domain models, Spring services and controllers directly from Claude Code. Includes 4 auto-activating skills (entity generation, JDL modeling, architectural patterns, microservices/gateway), 6 slash commands, 2 agents (JDL Architect, Forge Reviewer), and a session hook that auto-detects JHipster projects. Opinionated with production-grade patterns: Sealed Interface + Records, Strategy+Registry validation, Collect-Then-Fail, MapStruct polymorphic mapping. Supports JHipster 8.x monolith and microservices/gateway with Keycloak/OAuth2.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- bngesp
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 1
- Last push
- 2026-07-30T14:22:20Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
bngesp/jhipster-forge/jhipster-forge
README
# jhipster-forge > The first dedicated Claude Code plugin for JHipster 8.x Generate JHipster entities, DTOs, JDL models, services and more — directly from Claude Code, with production-grade architectural patterns built-in. ## Features - **Entity generation** with guided field/relationship collection - **JDL modeling** from natural language descriptions - **Architectural patterns** auto-applied: Sealed Interface + Records, Strategy+Registry, Collect-Then-Fail validation, MapStruct polymorphic mapping - **Microservices/Gateway** support with Keycloak/OAuth2 guidance - **Auto-detection** of JHipster projects at session start ## Prerequisites - [JHipster 8.x](https://www.jhipster.tech/) (`npm install -g generator-jhipster`) - Java 17+ - Node.js 18+ - Maven or Gradle ## Installation ```bash claude plugin install https://github.com/bngesp/jhipster-forge ``` ## Commands | Command | Description | |---|---| | `/jhipster-forge:forge-new [monolith\|microservice\|gateway]` | Scaffold a new JHipster project | | `/jhipster-forge:forge-entity [EntityName]` | Generate an entity with fields and relationships | | `/jhipster-forge:forge-jdl [description\|file.jdl]` | Create/import a JDL domain model | | `/jhipster-forge:forge-service [EntityName]` | Generate a Spring service layer | | `/jhipster-forge:forge-controller [EntityName]` | Generate a Spring REST controller | | `/jhipster-forge:forge-dto [EntityName]` | Generate a sealed interface + records DTO hierarchy with MapStruct mapper | | `/jhipster-forge:forge-validator [EntityName]` | Generate a Strategy+Registry validation layer with error accumulation | | `/jhipster-forge:forge-test [EntityName]` | Generate unit + integration tests for an entity's layers | | `/jhipster-forge:forge-liquibase` | Generate a Liquibase diff changelog | ## Agents ### `jdl-architect` Designs complete JDL models from natural language. Describe your domain, get a production-ready `.jdl` file. **Example:** > "I need a JDL for an e-commerce app with products, categories, orders and customers" ### `forge-reviewer` Reviews JHipster-generated code for architectural pattern compliance. Triggered automatically after entity generation. ## Skills (Auto-activated) | Skill | Triggers on | |---|---| | `entity-generation` | Entity creation, domain modeling | | `jdl-modeling` | JDL files, domain language questions | | `architecture-patterns` | Sealed Interface, Strategy, validation, MapStruct | | `microservices-gateway` | Microservice, gateway, Keycloak, Eureka | | `testing-patterns` | Unit/integration tests, Testcontainers, JUnit, Mockito | ## Hooks **Session start** — if a `.yo-rc.json` is detected in the project root, Claude displays: ``` ⚡ JHipster project detected: myApp (monolith, oauth2, postgresql) — use /jhipster-forge:forge-entity, /jhipster-forge:forge-jdl and more. ``` **Guard-rails (PreToolUse)**: - 🔒 **Blocks** edits to committed Liquibase changelogs — schema changes must go in a new changelog (checksums break on migrated databases); freshly generated, uncommitted changelogs stay editable - ⚠️ **Warns** on Java anti-patterns: `@Slf4j` (use `LoggerFactory`), field `@Autowired` (use constructor injection), `Double`/`Float` for monetary fields (use `BigDecimal`), `@Enumerated` without `EnumType.STRING` ## Architectural Patterns This plugin is opinionated and applies these patterns from the Spring Boot 3.x + JHipster 8.x stack: - **Sealed Interface + Records** — type-safe polymorphic DTOs (Java 17+) - **Strategy + Registry** — polymorphic validation via Spring-injected `Map<String, Validator>` - **Collect-Then-Fail** — `ValidationMonad` / `MessageList` for accumulating all errors - **Single Table Inheritance** — JPA entity hierarchy with `@DiscriminatorColumn` - **MapStruct Pattern Matching** — exhaustive mapping with Java 17 switch expressions - **RFC7807** — standardized HTTP error responses via Zalando Problem ## Compatibility - JHipster 8.x - Spring Boot 3.x - Java 17+ - Angular (frontend) - PostgreSQL (production), H2 (dev) - Monolith + Microservices/Gateway ## Author Bassirou Ngom — bassiroungom26@gmail.com ## License MIT