Quonet

A forum web application that allows users to create, delete, and like or dislike posts. Users can also update their profile information, including their username and bio. The platform supports content moderation through an admin dashboard.

www.quonet.dev

📁 Repositories

• Frontend
• Backend

📄 Summary

The frontend is built with Next.js following Bulletproof Architecture, leveraging server-side rendering for fast initial page loads, TanStack for client-side caching, and Zustand for centralized state management.

Backend is built with Go using Clean Architecture and implements a RESTful API with Fiber v2. PostgreSQL is used for data persistence via GORM, Redis handles rate limiting, and images are stored using Supabase.

💻 Tech Stack

• Frontend: Next.js, ShadCN, Tailwind CSS, Zod, TanStack, Zustand
• Backend: Go, Fiber, GORM, PostgreSQL, Redis
• Service: AWS, Supabase

🚀 Getting started

Prerequisites

• Go 1.25.2
• Docker
• Docker Compose

Setting up

Run this to clone project:

git clone https://github.com/mxilia/Quonet-backend.git

After that make sure your current directory is at the root of this project.

cd Quonet-backend

Run this to download Go package:

go mod download

Environment Variables

Make sure you use .env.dev when development and .env.production in production. Here is the variable list example:

ENV={dev or production}
DOMAIN=localhost

DB_HOST=localhost
DB_PORT=5432
DB_NAME=db_name
DB_USER=db_user
DB_PASSWORD=db_password

OWNER_EMAIL=xyz@email.com
OWNER_HANDLER=owner_handler

JWT_SECRET=nono22

FRONTEND_URL=https://localhost:3000
FRONTEND_OAUTH_REDIRECT_URL=http://localhost:3000

GOOGLE_CLIENT_ID=4567.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=4567
GOOGLE_OAUTH_REDIRECT_URL=http://localhost:8000/auth/google/callback

SUPABASE_URL=
SUPABASE_KEY=
BUCKET_NAME=

REDIS_ADDR=http://localhost:0000
REDIS_PASSWORD=

Write your own values for corresponding variables.

Usage

To run this project, you need to first open Docker Desktop then after that run this in terminal:

docker compose up --build

Then after that run:

go run cmd/app/main.go

And there you go, the backend is up and running.

Note

📁 /internal/app/server.go

6 | db, storage, _, rateLimiter, cfg, err := setupDependencies(CURRENT_ENV)

Make sure to replace CURRENT_ENV according to your environment:

• Set CURRENT_ENV = "production" for a production environment.
• Set CURRENT_ENV = "dev" for a development environment.

🧱 Project Structure

.
├── .github
│   └── workflows
│       └── cicd.yml
├── .vscode
│   └── settings.json
├── cmd
│   └── app
│       └── main.go
├── internal
│   ├── app
│   │   ├── app.go
│   │   └── server.go
│   ├── announcement
│   │   ├── dto
│   │   │   ├── mapper.go
│   │   │   ├── request.go
│   │   │   └── response.go
│   │   ├── handler
│   │   │   └── rest
│   │   │       └── handler.go
│   │   ├── repository
│   │   │   ├── announcement_repository.go
│   │   │   └── gorm_announcement_repository.go
│   │   └── usecase
│   │       ├── interface.go
│   │       └── usecase.go
│   ├── comment
│   │   ├── dto
│   │   │   ├── mapper.go
│   │   │   ├── request.go
│   │   │   └── response.go
│   │   ├── handler
│   │   │   └── rest
│   │   │       └── handler.go
│   │   ├── repository
│   │   │   ├── comment_repository.go
│   │   │   └── gorm_comment_repository.go
│   │   └── usecase
│   │       ├── interface.go
│   │       └── usecase.go
│   ├── entities
│   │   ├── announcement.go
│   │   ├── comment.go
│   │   ├── like.go
│   │   ├── post.go
│   │   ├── session.go
│   │   ├── thread.go
│   │   └── user.go
│   ├── like
│   │   ├── dto
│   │   │   ├── mapper.go
│   │   │   ├── request.go
│   │   │   └── response.go
│   │   ├── handler
│   │   │   └── rest
│   │   │       └── handler.go
│   │   ├── repository
│   │   │   ├── like_repository.go
│   │   │   └── gorm_like_repository.go
│   │   └── usecase
│   │       ├── interface.go
│   │       └── usecase.go
│   ├── post
│   │   ├── dto
│   │   │   ├── mapper.go
│   │   │   ├── request.go
│   │   │   └── response.go
│   │   ├── handler
│   │   │   └── rest
│   │   │       └── handler.go
│   │   ├── repository
│   │   │   ├── post_repository.go
│   │   │   └── gorm_post_repository.go
│   │   └── usecase
│   │       ├── interface.go
│   │       └── usecase.go
│   ├── session
│   │   ├── dto
│   │   │   ├── mapper.go
│   │   │   ├── request.go
│   │   │   └── response.go
│   │   ├── handler
│   │   │   └── rest
│   │   │       └── handler.go
│   │   ├── repository
│   │   │   ├── session_repostiory.go
│   │   │   └── gorm_session_repository.go
│   │   └── usecase
│   │       ├── interface.go
│   │       └── usecase.go
│   ├── thread
│   │   ├── dto
│   │   │   ├── mapper.go
│   │   │   ├── request.go
│   │   │   └── response.go
│   │   ├── handler
│   │   │   └── rest
│   │   │       └── handler.go
│   │   ├── repository
│   │   │   ├── thread_repository.go
│   │   │   └── gorm_thread_repository.go
│   │   └── usecase
│   │       ├── interface.go
│   │       └── usecase.go
│   ├── transaction
│   │   ├── interface.go
│   │   └── gorm_tx_manager.go
│   └── user
│       ├── dto
│       │   ├── mapper.go
│       │   ├── request.go
│       │   └── response.go
│       ├── handler
│       │   └── rest
│       │       └── handler.go
│       ├── repository
│       │   ├── user_repository.go
│       │   └── gorm_user_repository.go
│       └── usecase
│           ├── interface.go
│           └── usecase.go
├── pkg
│   ├── apperror
│   │   └── apperror.go
│   ├── config
│   │   └── config.go
│   ├── database
│   │   ├── db.go
│   │   └── storage.go
│   ├── middleware
│   │   ├── fiber.go
│   │   ├── jwt.go
│   │   ├── require_admin.go
│   │   └── rate_limit
│   │       ├── key.go
│   │       ├── policy.go
│   │       └── rate_limit.go
│   ├── redisclient
│   │   ├── client.go
│   │   └── kv.go
│   ├── responses
│   │   ├── error_response.go
│   │   └── message_response.go
│   ├── routes
│   │   ├── not_found_route.go
│   │   ├── private_routes.go
│   │   └── public_routes.go
│   └── token
│       ├── claims.go
│       └── jwt_maker.go
├── utils
│   └── format
│        └── format.go
├── .dockerignore
├── .env.dev
├── .env.example
├── .env.production
├── .gitignore
├── docker-compose.yml
├── Dockerfile
├── go.mod
├── go.sum
├── LICENSE
└── README.md

📍 API Endpoints

/api/v2

Route	Auth Requirement	Params	Description
GET /me	Authenticated	-	Returns current user's info.
GET /auth/google/login	Public	-	Redirects user to Google OAuth Page.
GET /auth/google/callback	Public	-	Handles Google OAuth callback.
POST /auth/logout	Authenticated	-	Delete current user's session.
GET /threads	Public	title, page	Returns threads that match params.
GET /threads/:id	Public	id	Returns a thread with specified id.
POST /threads	Admin	-	Creates a new thread.
DELETE /threads/:id	Admin	-	Delete a thread with specified id.
PATCH /sessions/:email	Admin	email	Patch a session with specified id.
GET /users	Public	-	Returns all users.
GET /users/:id	Public	id	Returns a user with specified id.
GET /users/handler/:handler	Public	handler	Returns a user with specified handler.
GET /users/email/:email	Public	email	Returns a user with specified email.
PATCH /users/:id	Authenticated	-	Update user with specified id.
DELETE /users/:id	Authenticated	-	Delete user with specified id.
GET /posts	Public	page, author_id, thread_id, title	Returns posts that match params.
GET /posts/:id	Public	id	Returns a post with specified id.
GET /posts/top/like	Public	limit	Returns a limited number of posts sorted by like count in descending order.
GET /posts/private	Authenticated	page, author_id, thread_id, title	Returns private posts that match params.
GET /posts/private/:id	Authenticated	id	Returns a private post with specified id.
POST /posts	Authenticated	-	Creates a new post.
PATCH /posts/:id	Authenticated	id	Update a post with specified id.
DELETE /posts/:id	Authenticated	id	Delete a post with specified id.
GET /likes	Public	page, parent_type, owner_id, parent_id	Returns likes that match params.
GET /likes/:id	Public	id	Returns a like with specified id.
GET /likes/attributes/count	Public	parent_type, parent_id, owner_id	Return a list of number representing entities' like count that match params.
GET /likes/attributes/state	Authenticated	parent_type, parent_id	Return current user like state for the given parent.
POST /likes	Authenticated	-	Create a new like.
GET /comments	Public	root_id, parent_id, owner_id	Returns comments that match params.
GET /comments/:id	Public	id	Returns a comment with specified id.
POST /comments	Authenticated	-	Create a new comment.
PATCH /comments/:id	Authenticated	-	Update a comment with specified id.
DELETE /comments/:id	Authenticated	-	Delete a comment with specified id.
GET /announcements	Public	page	Returns announcements that match params.
POST /announcements	Admin	-	Create a new announcement.
DELETE /announcements	Admin	id	Delete an announcement with specified id.