README.md

Devsoc Backend '25

The official Backend API for DEVSOC'25 Hackathon Portal

Features

• Fully-featured REST API built with Go
• Postgres integration using SQLC for typesafe bindings
• Structured routing and controllers
• JWT authentication and middleware
• Comprehensive logging and error handling
• Docker and docker-compose configuration for containerized deployment
• API documentation generation via scalar

Tech Stack

• Go
  • Echo: Minimalist Go web framework
  • SQLC: Type-safe Go from SQL
  • pgx: PostgreSQL driver for Go
  • gomail: Send emails in Go
  • go-redis: Redis client for Go
• PostgreSQL: Open-source relational database
• Docker: Container platform
• Redis: In-memory data store
• Goose: DB migration tool for Go

How To Run

Clone the repo

$ git clone https://github.com/CodeChefVIT/devsoc-be-25
$ cd devsoc-be-25

Download Dependencies

$ go mod download

Fill Environment Variables

$ cp .env.sample .env

Start Containers

$ docker compose up --build

Apply Migrations

$ make up

Contributors

Vedant Matanhelia	Soham Mahapatra	Aman L	Vaibhav Sijaria
Jothish Kamal	Aman Singh	Abhinav Anand	Abhinav Ganeshan
Abhinav Garg	Abhinav Pant	Nishant Gupta

License

Copyright © 2025, CodeChef-VIT and all other contributors. Released under the MIT License.

Made with ❤️ by CodeChef-VIT