Kurin

A microblogging application that allows users to share text, images, and comments in a social feed.

Basic Features

• User registration, login, and logout
• Search for other users
• Follow and unfollow users
• Create text and image posts
• Like posts from other users
• View own posts, another user’s posts, and an aggregated feed of followed users
• Responsive user interface

Extra Features 🚀

• Comment on posts
• Attach images to posts (stored in Amazon S3)
• Delete own posts
• Unlike previously liked posts
• Authenticate users via OAuth

Technologies Used

• Frontend: React, Tailwind CSS
• Backend: Java, Spring Boot
• Database: MariaDB
• Authentication: OAuth
• Image Storage: Amazon S3
• Containerization: Docker

Run with Docker 🐳

You can containerize and run the entire application stack (frontend, backend, and database) using Docker Compose.

1. Build and Start All Services

From the root of the project directory, run:

docker-compose up -d --build

2. Access the Application

Once the containers are running:

• Frontend: http://localhost:80
• Backend API: http://localhost:8080
• MariaDB: Accessible internally as db:3306, with:
  • Database: kurin
  • Username: root
  • Password: asdf1234

3. Stop the Services

To stop all running containers:

docker-compose down

Academic Project

This application was developed individually as part of the Web Technology Project (WTP) course in the International Computer Science degree program at OTH Regensburg. It was created and is intended for educational and learning purposes only.