Repository navigation

GoSocial

A personal project to learn Go by building a social media platform with JWT authentication, posts, and a Next.js frontend.

Learning Goals

Go backend development with Chi router
JWT authentication and middleware
PostgreSQL database operations
CI/CD pipelines (Versioning/Migrations/Tests/ImageBuilder/AWS deploy)

Tech Stack

Backend: Go, Chi Router, PostgreSQL, JWT
Frontend: Next.js, TypeScript, Tailwind CSS
Database: PostgreSQL with Docker

Prerequisites

Go 1.25+
Node.js 20+
Docker

Run

1. Start Database

docker-compose up -d

2. Initialize Database

psql -h localhost -U admin -d social -f scripts/db_init.sql

3. Run Backend

go run cmd/api/*.go

API runs on http://localhost:8080

4. Run Frontend

cd web
npm install
npm run dev

Frontend runs on http://localhost:3000

Current API Endpoints

POST /v1/auth/register - User registration
POST /v1/auth/login - User login
GET /v1/users/me - Get user profile (auth required)
GET /v1/posts - Get posts (auth required)
GET /v1/health - Health check

Planned Features