Social Monorepo

Warning

This monorepo replaces the previously separate repositories: social-backend: https://github.com/deniSSTK/social-backend social-frontend: https://github.com/deniSSTK/social-frontend

Note

The demo is currently down because the backend is not deployed.

This repository contains the full Social app in one place:

• frontend/: Vue 3 + TypeScript + Vite client
• backend/: Go API
• docker-compose.yml: local container orchestration for the whole stack

Overview

The frontend and backend now live side by side in a single repository so the app can be developed, shipped, and deployed from one root. The monorepo setup keeps Docker, environment configuration, and project documentation centralized.

Architecture

.
├── backend
│   ├── cmd/app
│   ├── internal
│   └── Dockerfile
├── frontend
│   ├── nginx
│   ├── src
│   └── Dockerfile
├── docker-compose.yml
└── README.md

At runtime:

• PostgreSQL runs in Docker
• the Go backend serves the API on :8080
• nginx serves the built frontend and proxies /api to the backend

Run With Docker

1. Copy the root example env file:

   cp .env.example .env

2. Fill in real secrets, especially JWT_SECRET and IMGBB_API_KEY.

3. Start the stack from the repo root:

   docker compose up --build

4. Open the app at http://localhost:3000.

Run Locally Without Docker

Backend

1. Copy the backend env file:

   cp backend/.env.example backend/.env

2. Make sure PostgreSQL is running and matches backend/.env.

3. Start the API:

   cd backend
   go run ./cmd/app

Frontend

1. Install dependencies:

   cd frontend
   npm install

2. Optionally copy the frontend env example if you want to customize the Vite dev proxy target:

   cp .env.example .env

3. Start the Vite dev server:

   npm run dev

By default, the frontend uses /api and the Vite dev server proxies that traffic to http://localhost:8080.