Acolyte — Spring Boot Code Generator CLI

Acolyte is a command-line tool designed to boost your productivity in Spring Boot projects by automating the creation of common boilerplate code. It helps maintain a clean and standardized package structure, making your development process faster, more consistent, and less error-prone.

It supports generating entities, services, repositories, controllers, views, configuration files, and more — all with a single command.

🚀 Available Commands

📦 Make Entity

Generates a JPA entity class with a basic structure.

java acolyte make:entity <Entity-Name>
# Example:
java acolyte make:entity User

👁️ Make View

Creates a Thymeleaf view file with the specified name.

java acolyte make:view <view-name>
# Example:
java acolyte make:view user-list

🎮 Make Controller

Generates a Spring controller class. You can optionally scaffold common REST methods using --resource.

java acolyte make:controller <Controller-Name> [--resource <methods>]

# Examples:
java acolyte make:controller UserController
java acolyte make:controller UserController --resource
java acolyte make:controller UserController --resource index save destroy

📄 Make DTO or POJO

Creates a Data Transfer Object or plain Java class.

java acolyte make:dto <Dto-Name>
# Example:
java acolyte make:dto UserDto

🛠️ Make Service

Generates a service class and optionally an interface following the service pattern.

java acolyte make:service <Service-Name>
# Example:
java acolyte make:service UserService

🗃️ Make Repository

Creates a JPA repository interface for a given entity.

java acolyte make:repository <Entity-Name>
# OR
java acolyte make:repo <Entity-Name>

# Example:
java acolyte make:repo User

⚙️ Make Configuration

Creates a configuration class annotated with @Configuration.

java acolyte make:configuration <Config-Class-Name>
# OR
java acolyte make:config <Config-Class-Name>

# Example:
java acolyte make:config WebConfig

✅ Make Validator

Creates a custom validator class and links it to a DTO for form validation.

java acolyte make:validator <Validator-Class-Name> --dto=<Dto-Class-Name>
# Example:
java acolyte make:validator UserValidator --dto=UserDto

🎧 Make Listener

Generates an entity listener for lifecycle callbacks.

java acolyte make:listener <Listener-Class-Name>
# Example:
java acolyte make:listener UserListener

Usage in Entity:

@EntityListeners(UserListener.class)
public class User {
    // fields
}

🧩 Make Fragment / Component

Generates a reusable Thymeleaf HTML fragment/component.

java acolyte make:fragment <fragment-path>
# OR
java acolyte make:component <component-path>

# Example:
java acolyte make:fragment admin/layout/header
java acolyte make:component admin/layout/header

Usage in Thymeleaf:

<th:block th:replace="~{/admin/layout/header :: header}"></th:block>

📚 Benefits of Using Acolyte

✅ Eliminate repetitive code writing
✅ Maintain consistent folder structure
✅ Focus on business logic, not scaffolding
✅ Easy integration with any Spring Boot project
✅ Supports modular architecture and reusability

🧪 Coming Soon

Here are the upcoming features planned for Acolyte CLI to make it even more powerful and developer-friendly:

make:model – Generate Entity, DTO, Repository, Service, and Controller in one shot.
make:test – Create test classes for services, controllers, or repositories using JUnit.
make:request – Generate form request classes with built-in validation annotations.
make:enum – Create a type-safe Enum with custom values.
make:interceptor – Scaffold Spring's HTTP interceptor for custom middleware.
make:resource – Generate a standardized API response wrapper class.
make:scheduler – Create a class with a @Scheduled job using cron expression.
make:runner – Create a class that runs logic on app startup via CommandLineRunner.
make:exceptionhandler – Scaffold a global exception handler with @ControllerAdvice.
make:configprops – Generate @ConfigurationProperties class for binding custom configs.
wizard – Interactive CLI flow to build modules step-by-step.
custom templates – Allow users to plug in their own code templates.
i18n support – Generate language properties files for multi-language apps.
thymeleaf-page – Scaffold Thymeleaf pages like forms or lists with mock data bindings.

Feel free to contribute or suggest features to make Acolyte even more powerful!

ProjectsAndPrograms/acolyte