Future Feed by Syntex Squad

Project Description:

Future Feed (FF) is a social media platform that lets users take direct control of their content feeds through customizable feed presets and, in future iterations, AI-powered bots.

This project is developed by Syntex Squad for the COS 301 Capstone Project, in collaboration with EPI-USE Labs.

Code Quality Badges

Issue Tracking

GitHub

Links:

Architectural Specifications | Requirement Specifications | Design Specifications | GitHub Project Board Link
Manuals | Coding Standards/quality | Testing Policy Document

---

Architectural Diagram | Deployment Model | Domain Model |
Gantt Chart | Use Case Diagrams

Demo links:

Demo	Link
Demo 1 Video	Watch Video
Demo 1 Presentation	View Slides
Demo 2 Video	Watch Video
Demo 2 Presentation	View Slides
Demo 3 Video	Watch Video
Demo 3 Presentation	View Slides
Demo 4 Video	Watch Video
Demo 4 Presentation	View Slides
Project Day Demo	Watch Video

Deliverables:

100% completion of the working prototype (Deployed)
Architectural structural design & requirements
Quality Requirements and its testing
Coding Standards Document
Testing Policy document
User Manual
Technical Installation Manual
Requirements and design specifications

Technologies Used

Layer	Technology	Logo
Frontend	React (TSX) + Vite
	Tailwind CSS
	JavaScript
	ShadCN/UI
Backend	OAuth 2.0
	Spring Boot
	PostgreSQL

Team Members:

Member	Roles	Skills	LinkedIn	Github
Lesedi Manoto 22564812	Project Manager Frontend Developer Integration Engineer	Java, Python, C++, HTML/CSS/JS, SQL
Uminathi Mdluli 22567659	Frontend Developer Integration Engineer	Java, Python, C++, HTML/CSS/JS, NodeJS
Jongisapho Ndeya 22625926	Front-End Developer Integration Engineer DevOps Engineer	Java, Python, C++, HTML/CSS, JS/ReactJs, TailwindCSS/NodeJS, SQL
Rethabile Mokoena 23815087	Backend Developer	Java, Python, C++, HTML/CSS/JS, NodeJS
Oarabile Matlala 21740012	Backend Developer Testing Engineer Cloud Engineer AI Systems Engineer	Java, C++, C#, ASP.NET, HTML/Javascript/CSS/PHP/Node.js

Getting Started

Clone the Repository:

git clone https://github.com/SyntexSquad/FutureFeed.git
cd FutureFeed

Install Dependencies:

cd frontend
npm install

Get Started:

To run frontend:

cd frontend
npm run dev

To run backend:

Make sure you have mvn installed and then:

cd FutureFeed-Springboot/futurefeed
mvn spring-boot:run

To run ai bot moderator:

cd AI-Bot
docker build -t my-ai-bot .
docker run -d -p 8000:8000 --name ai-bot-container my-ai-bot

Deployment link:

Future Feed

Running Tests

Unit Testing
Integration Testing

GitHub Repository

Structure

The entire codebase is stored in one repository.

Branching Strategy

We use Gitflow as our branching model/strategy

main: Production-ready code <br>
dev: Integration branch for features <br>
feature: Feature branches <br>
Some branches are created from issues so they will have the issue number there

PRs require at least one review (one more person should review the PR) before merging.

Contact

Team Email: syntaxsquad@gmail.com

Clients:

Simran Rathilal, Tobias Bester, Victor Igbojinna (EPI-USE Labs)

Course:

COS 301, University of Pretoria, 2025