A production-grade blogging platform built with Go and Chi router. It has features like auth, full-text search, prometheus metrics, email activation, rate limiting, etc. It also features a simple CI workflow that builds the binary, dockerfile and docker compose.
Interactive API documentation is available through Postman:
Test user credentials(both accounts are activated):
- username:
infamous03password:password123email:infamous@gmail.com - username:
mehdi123password:password123email:mehdi@gmail.com
The collection includes:
- Authentication flow (register → activate → login)
- Full CRUD for posts
- Publishing workflow
- Comment management
- Pagination & filtering examples
- Health check endpoint
You can fork the collection or import it directly into Postman to test against the deployed API.
https://go-blog-wrxl.onrender.com/
https://go-blog-wrxl.onrender.com/healthcheck
- Registration with email delivery containing an activation code
- Account activation flow
- Secure token-based authentication
- Full CRUD for posts
- Publish support
- Clapping (voting) mechanism
- PostgreSQL text-search integrated into list endpoint
- CRUD for post-specific comments
- Protected by user authentication
- Rate limiting per client
- Custom validation layer
- Middlewares for Auth, Metrics, etc
- Database migrations
- Docker & Docker Compose environment
- Prometheus metrics endpoint (
/metrics)
Below is the complete route map of the server:
| Method | Route | Description |
|---|---|---|
| GET | /healthcheck |
Server status |
| POST | /users |
Register a user |
| PUT | /users/activated |
Activate user account |
| POST | /tokens/authentication |
Get auth token |
All authenticated routes require a valid token and an activated account.
| Method | Route | Description |
|---|---|---|
| GET | /users/me |
Get current user's profile |
| Method | Route | Description |
|---|---|---|
| POST | /posts |
Create post |
| GET | /posts |
List posts (search & filters) |
| GET | /posts/{id} |
Fetch a post |
| PATCH | /posts/{id} |
Update a post |
| DELETE | /posts/{id} |
Delete a post |
| POST | /posts/{id}/publish |
Publish a post |
| POST | /posts/{id}/clap |
Clap(vote) a post |
| Method | Route | Description |
|---|---|---|
| POST | /posts/{id}/comments |
Create comment |
| GET | /posts/{id}/comments |
List comments |
| PATCH | /posts/{id}/comments/{comment_id} |
Update comment |
| DELETE | /posts/{id}/comments/{comment_id} |
Delete comment |
- Go
- Chi Router
- PostgreSQL
- Go Migrate
- Prometheus
- Docker & Docker Compose
- GitHub Actions
MIT