Skip to content

Commit 8de2a66

Browse files
authored
Merge pull request #6 from DFanso/dev
Dev
2 parents 5c36007 + c49ce75 commit 8de2a66

File tree

1 file changed

+99
-1
lines changed

1 file changed

+99
-1
lines changed

README.md

Lines changed: 99 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,99 @@
1-
# spring-boot-jwt-auth-api
1+
# Spring Boot JWT Auth API 🌐🧑‍💻
2+
3+
![GitHub forks](https://img.shields.io/github/forks/DFanso/spring-boot-jwt-auth-api?style=for-the-badge&logo=github)
4+
 
5+
![GitHub license](https://img.shields.io/github/license/DFanso/spring-boot-jwt-auth-api?style=for-the-badge&logo=github)
6+
 
7+
![GitHub stars](https://img.shields.io/github/stars/DFanso/spring-boot-jwt-auth-api?style=for-the-badge&logo=github)
8+
 
9+
10+
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/DFanso/spring-boot-jwt-auth-api/build.yml?style=for-the-badge)
11+
 
12+
13+
![GitHub last commit](https://img.shields.io/github/last-commit/DFanso/spring-boot-jwt-auth-api?style=for-the-badge)
14+
 
15+
16+
17+
18+
## Overview
19+
20+
This project is a Spring Boot application with JWT authentication. It provides a robust and secure API for authentication and authorization using JSON Web Tokens (JWT).
21+
22+
## Features
23+
24+
- **Spring Boot** - for building the backend application.
25+
- **JWT** - for secure authentication and authorization.
26+
- **Spring Security** - to secure the application.
27+
- **Maven** - for dependency management.
28+
- **H2 Database** - in-memory database for development and testing.
29+
- **Postgres Database** - Sequel database for persistence data.
30+
31+
## Technologies
32+
33+
![Spring Boot](https://img.shields.io/badge/-Spring_Boot-6DB33F?style=for-the-badge&logo=spring-boot)
34+
![Java](https://img.shields.io/badge/-Java-007396?style=for-the-badge&logo=java)
35+
![JWT](https://img.shields.io/badge/-JWT-000000?style=for-the-badge&logo=json-web-tokens)
36+
![Maven](https://img.shields.io/badge/-Maven-C71A36?style=for-the-badge&logo=apache-maven)
37+
![H2 Database](https://img.shields.io/badge/-H2-4479A1?style=for-the-badge&logo=h2)
38+
![H2 Database](https://img.shields.io/badge/postgresql-4169e1?style=for-the-badge&logo=postgresql&logoColor=white)
39+
![Jenkins](https://img.shields.io/badge/-Jenkins-000?style=for-the-badge&logo=jenkins)
40+
 
41+
![Docker](https://img.shields.io/badge/-Docker-2496ED?style=for-the-badge&logo=docker)
42+
 
43+
![GitHub](https://img.shields.io/badge/-GitHub-181717?style=for-the-badge&logo=github)
44+
45+
46+
47+
48+
## Getting Started
49+
50+
### Prerequisites
51+
52+
- Java 21 or higher
53+
- Maven 3.6.3 or higher
54+
55+
### Installation
56+
57+
1. Clone the repository:
58+
```sh
59+
git clone https://github.com/DFanso/spring-boot-jwt-auth-api.git
60+
```
61+
2. Navigate to the project directory:
62+
```sh
63+
cd spring-boot-jwt-auth-api
64+
```
65+
3. Build the project using Maven:
66+
```sh
67+
mvn clean install
68+
```
69+
4. Run the application:
70+
```sh
71+
mvn spring-boot:run
72+
```
73+
74+
### Usage
75+
76+
- Access the application at `http://localhost:8080`.
77+
- Use tools like Postman or curl to test the API endpoints.
78+
79+
## API Endpoints
80+
81+
- `POST /api/auth/register` - Register a new user.
82+
- `POST /api/auth/login` - Authenticate a user and get a token.
83+
- `GET /api/auth/profile` - Get user's profile.
84+
85+
## Contributing
86+
87+
Contributions are welcome! Please fork the repository and create a pull request.
88+
89+
## License
90+
91+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
92+
93+
## Contact
94+
95+
- GitHub: [DFanso](https://github.com/DFanso)
96+
97+
---
98+
99+
Happy coding! 🚀

0 commit comments

Comments
 (0)