trobert42 / transcendence

A website that includes a Pong game and a real-time chat

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Website with a pong game and real-time chat

It is the final project of the common core, time to learn some web stuff !

The project involves creating a website featuring an interactive Pong game and a matchmaking system. Client users can create accounts, log in to chat and play.

Project Name ft_transcendence
Description A website that runs an online multiplayer pong, a real-time chat and a user management system
Technologies React Nest Docker PostgreSQL Prisma

Features

  • User's features include profile data, settings, friend lists, private chats, custom avatars, game stats, and match history.
  • Authentication management is handled using the 42 API (OAuth2) and Google Authenticator for 2FA.
  • Database management employs an ORM (Object Relational Mapping), Prisma, connecting the server to a PostgreSQL database, ensuring password security and protection against injections via POST forms.
  • The frontend built using React, on port 3333.
  • The Backend development utilizes NestJS, providing a project architecture and tools for creating a REST API to enable coherent and structured communication between systems via HTTP. On port 3000.
  • It is Docker-compatible using docker-compose.
  • Chat channel management involves websockets programming, supporting both public and private channels.
  • The website is one-page and responsive.

Prerequisite

To run the project, you have to install docker-compose and docker. You need to rename "example.env" to ".env" and setup the file .env with your credentials and 42 API credentials.

  gcl https://github.com/trobert42/transcendence.git
  cd transcendence
  mv example.env .env
  code .env #or vi .env

You have to put a password for the jwt secret and for the refresh jwt secret. You need also to put your 42 API credentials, if you don't it won't work.

...
JWT_SECRET=""
JWT_REFRESH_SECRET=""
API_42_UID=""
API_42_PWD=""
...

Usage

  make

When the containers are done building up and are running, you go to your chrome browser (firefox also works) and write on the URL bar "localhost:3000" to access to the application.

Screenshots

Here are the ideas we gathered and drew on Figma:

And look how the website ended up ! We succeed to realize what we wanted to display.

💬

Big thanks to Antoine, Pierre, Elsie and Cyril! We ended the final project together, we can be proud :D It was a wonderful group experience. I think we gained valuable experience in collaboration, problem-solving, and technical skills development. I really feel a sense of accomplishment and satisfaction in seeing our project come to fruition despite the challenges we faced along the way !

About

A website that includes a Pong game and a real-time chat


Languages

Language:TypeScript 87.6%Language:CSS 11.5%Language:HTML 0.4%Language:Makefile 0.4%Language:Dockerfile 0.1%Language:Shell 0.0%