Gator Marketplace

Gator Marketplace is an online platform that connects buyers and sellers within the UF community. Users can post listings, browse products, and securely complete transactions, all in one convenient app.

---

Project Structure

gator-marketplace/
├── marketplace-fe/   # Angular frontend
├── marketplace-be/   # Gin backend

---

Getting Started

Prerequisites

Ensure the following tools are installed:

• Node.js (v16+)
• Angular CLI (v19.1.4+)
• Go (v1.18+)
• PostgreSQL
• AWS S3
• Google Maps API
• (Optional) Docker & Docker Compose

Carefully read the README.md files in both marketplace-fe/ and marketplace-be/ for detailed setup instructions specific

Frontend (Angular)

Installing Dependencies

cd marketplace-fe
npm install

Running the Development Server

ng serve

Visit http://localhost:4200/ to see the app running. It will auto-reload on source changes.

Building the Project

ng build         # Dev build
ng build --prod  # Production build

Running Unit Tests

ng test

Running E2E Tests (with Cypress)

Ensure Cypress is installed and configured. Then:

npx cypress open

or run headlessly:

npx cypress run

---

Backend (Gin + PostgreSQL)

Clone & Navigate

git clone <repository-url>
cd marketplace-be

Install Go Modules

go mod tidy

Setup PostgreSQL

Option 1: Manual Setup

-- Replace <USER>, <PASSWORD>, <DB> accordingly
CREATE USER <USER> WITH PASSWORD '<PASSWORD>';
CREATE DATABASE <DB>;
GRANT ALL PRIVILEGES ON DATABASE <DB> TO <USER>;
\c <DB> postgres
GRANT ALL ON SCHEMA public TO <USER>;

Option 2: With Docker

docker-compose up -d

Creates:

• User: gator
• DB: marketplace
• Password: from .env file

Environment Variables

Create a .env file in the root of the backend directory:

cp .env.example .env

Generate a JWT secret:

openssl rand -base64 32

Update the database URL, JWT secret, and other values as needed.

Running the Server

go run main.go

Backend starts on the port defined in .env (default: 5000).

---

Linting & Code Quality

Angular

ng lint

Go

Use golangci-lint or go fmt for linting and formatting.

---

Additional Resources

• Angular CLI Documentation
• Gin Framework Docs
• PostgreSQL Docs
• Cypress Testing