https://github.com/vultrnerd/hexarch-demo
Sample hexagonal architecture implementation
https://github.com/vultrnerd/hexarch-demo
angular hexagonal-architecture spring-boot
Last synced: 2 months ago
JSON representation
Sample hexagonal architecture implementation
- Host: GitHub
- URL: https://github.com/vultrnerd/hexarch-demo
- Owner: vultrnerd
- Created: 2025-08-22T07:43:01.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-22T09:19:56.000Z (10 months ago)
- Last Synced: 2025-08-22T11:36:04.365Z (10 months ago)
- Topics: angular, hexagonal-architecture, spring-boot
- Language: Java
- Homepage:
- Size: 2.38 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hexarch Demo Project
This project consists of a frontend application built with Angular and a backend built with Spring Boot following the hexagonal architecture pattern.
## Project Structure
- `ng-app/`: Frontend application built with Angular 20.1.6
- `spring-hexarch-backend/`: Backend application built with Spring Boot 3.5.4
## Prerequisites
- Node.js 22.17 and npm (for the frontend)
- Java 21 and Maven (for the backend)
## Building and Running the Frontend
1. Navigate to the frontend directory:
```bash
cd ng-app
```
2. Install dependencies:
```bash
npm install
```
3. Start the development server:
```bash
ng serve
```
Once the server is running, open your browser and navigate to `http://localhost:4200/`. The application will automatically reload whenever you modify any of the source files.
4. To build the project for production:
```bash
ng build
```
This will compile your project and store the build artifacts in the `dist/` directory.
## Building and Running the Backend
1. Navigate to the backend directory:
```bash
cd spring-hexarch-backend
```
2. Build the project:
```bash
mvn clean install
```
3. Run the application:
```bash
mvn spring-boot:run
```
The backend will start and be available at `http://localhost:8080` by default.
## Additional Resources
- [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli)
- [Spring Boot Reference Guide](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/)