https://github.com/zckyachmd/hono-auth
Hono-Auth is a lightweight authentication boilerplate created with Hono.js and Bun. It offers essential features and functionality for building secure and efficient web applications.
https://github.com/zckyachmd/hono-auth
auth bun honojs jwt open-api prisma-orm swagger-api typescript
Last synced: 3 months ago
JSON representation
Hono-Auth is a lightweight authentication boilerplate created with Hono.js and Bun. It offers essential features and functionality for building secure and efficient web applications.
- Host: GitHub
- URL: https://github.com/zckyachmd/hono-auth
- Owner: zckyachmd
- License: mit
- Created: 2024-09-08T07:11:32.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-10-18T00:30:24.000Z (9 months ago)
- Last Synced: 2025-03-25T23:15:17.865Z (4 months ago)
- Topics: auth, bun, honojs, jwt, open-api, prisma-orm, swagger-api, typescript
- Language: TypeScript
- Homepage:
- Size: 40 KB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Hono Auth
**Hono-Auth** is a simple authentication boilerplate built with Hono.js using Bun and TypeScript, designed to provide essential auth functionality. This project includes four key authentication endpoints and leverages Prisma ORM for database management, Zod for validation, and Swagger UI for API documentation.
## Features
- User Authentication: Includes user registration, login, logout, and token refresh.
- Zod Validation: Schema validation for secure data handling.
- Swagger UI: Auto-generated API docs for easy testing and integration.
- Dynamic Role Access Control: Enhanced role management allowing for flexible access control based on user roles and hierarchy.
- Role Hierarchy Filtering: Implemented filtering logic to ensure only appropriate roles are included in access checks, improving security and clarity.
## Tech Stack (Framework & Libraries)
- Hono.js (Bun & TypeScript)
- Prisma ORM (PostgreSQL)
- Swagger UI (Scalar)
- Zod (Data Validation)
## Endpoints
| Endpoint | Method | Description |
| ------------------- | ------ | -------------------- |
| /auth/register | POST | Register a new user |
| /auth/login | POST | Log in a user |
| /auth/refresh-token | POST | Refresh access token |
| /auth/logout | POST | Log out a user |
| /auth/me | GET | Get user information |
## Setup and Usage
Click to expand
1. Clone the repository and install dependencies:
```bash
git clone https://github.com/zckyachmd/hono-auth.git
cd hono-auth
bun install
```
2. Create a `.env` file in the root directory:
```bash
cp .env.example .env
nano .env # Edit the variables as needed (see below)
#... (.env)
DATABASE_URL=postgresql://user:password@localhost:5432/database?schema=public
JWT_SECRET=your-secret-token
SALT_ROUNDS=10 # Number of rounds for password hashing
```
3. Migrate the database:
```bash
bun prisma migrate dev
```
4. Start the server:
```bash
bun run dev
# Open http://localhost:3000/ui in your browser
```
## Contributing
Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE.md) file for more information.