{"id":19675447,"url":"https://github.com/kuninoto/42_ft_transcendence","last_synced_at":"2026-08-12T20:30:21.053Z","repository":{"id":195411677,"uuid":"633617863","full_name":"Kuninoto/42_ft_transcendence","owner":"Kuninoto","description":"A website with user accounts/profiles and relations (friendships \u0026 blocks), real-time multiplayer game and chat (DMs \u0026 rooms)!","archived":false,"fork":false,"pushed_at":"2025-04-01T22:22:44.000Z","size":21374,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-08-07T17:27:33.436Z","etag":null,"topics":["nestjs","nestjs-backend","nestjs-postgresql","nextjs","reactjs","socket-io","socketio","swagger","swagger-ui","tailwind-css","tailwindcss","typeorm"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kuninoto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-04-27T22:58:33.000Z","updated_at":"2025-10-03T22:16:52.000Z","dependencies_parsed_at":"2025-09-01T02:43:07.672Z","dependency_job_id":null,"html_url":"https://github.com/Kuninoto/42_ft_transcendence","commit_stats":null,"previous_names":["kuninoto/42_ft_transcendence"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Kuninoto/42_ft_transcendence","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuninoto%2F42_ft_transcendence","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuninoto%2F42_ft_transcendence/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuninoto%2F42_ft_transcendence/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuninoto%2F42_ft_transcendence/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kuninoto","download_url":"https://codeload.github.com/Kuninoto/42_ft_transcendence/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kuninoto%2F42_ft_transcendence/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36581544,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-06T04:43:03.162Z","status":"online","status_checked_at":"2026-08-12T02:00:07.134Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nestjs","nestjs-backend","nestjs-postgresql","nextjs","reactjs","socket-io","socketio","swagger","swagger-ui","tailwind-css","tailwindcss","typeorm"],"created_at":"2024-11-11T17:24:06.523Z","updated_at":"2026-08-12T20:30:21.047Z","avatar_url":"https://github.com/Kuninoto.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ft_transcendence (42Porto - 42Cursus)  \n\n#### Project done in collaboration with  \n[Rodrigo Ramos](https://github.com/ramos21rodrigo)  \n[João Arsénio](https://github.com/RealMadnessWorld)  \n\n### Demonstration  \n![printscreen of the auth page](./extras/auth_page.png)  \n![printscreen of the dashboard page](./extras/dashboard.png)  \n![printscreen of the user's profile page](./extras/user_profile_page.png)  \n\n### Description  \nA website to host the might pong contest!  \n\n\u003e Disclaimer: Only tested on Google Chrome and Brave (Also works on Firefox but has a **visual** bug on user's profile avatar update field)\n\n### Features\n- User accounts/profiles and relations (friendships \u0026 blocks)  \n- OAuth2 Login with 42's intranet and 2FA with Google Authenticator  \n- Chat (groups with roles (owner, admin and participant) and DMs)  \n- Pong game (with themes!)  \n- Matchmaking, 1v1 and match history  \n\n### Stack Used  \n\u003cimg src=\"https://github.com/devicons/devicon/blob/master/icons/typescript/typescript-original.svg\" title=\"TypeScript\" alt=\"TS Logo\" width=\"50\" height=\"50\" /\u003e\u0026nbsp; \u003cimg src=\"https://github.com/devicons/devicon/blob/master/icons/nextjs/nextjs-original.svg\" title=\"NextJS\" alt=\"NextJS Logo\" width=\"50\" height=\"50\" /\u003e\u0026nbsp; \u003cimg src=\"https://github.com/devicons/devicon/blob/master/icons/tailwindcss/tailwindcss-original.svg\" title=\"Tailwindcss\" alt=\"Tailwindcss Logo\" width=\"50\" height=\"50\" /\u003e\u0026nbsp;  \n\u003cimg src=\"https://github.com/devicons/devicon/blob/master/icons/nestjs/nestjs-original.svg\" title=\"NestJS\" alt=\"NestJS Logo\" width=\"50\" height=\"50\" /\u003e\u0026nbsp;\n\u003cimg src=\"https://github.com/devicons/devicon/blob/master/icons/postgresql/postgresql-original.svg\" title=\"PostgreSQL\" alt=\"PostgreSQL Logo\" width=\"50\" height=\"50\" /\u003e\u0026nbsp;\n\u003cimg src=\"https://github.com/devicons/devicon/blob/master/icons/docker/docker-original.svg\" title=\"Docker\" alt=\"Docker Logo\" width=\"65\" height=\"65\" /\u003e  \n\n## Grade: 100/100  \n\n### Installing and running the project  \n1- Install Docker: [install Docker engine official docs](https://docs.docker.com/engine/install/)  \n2- Clone this repository\n\n    git clone https://github.com/Kuninoto/42_ft_transcendence ft_transcendence\n3- Navigate to _ft_transcendence_\n\n    cd ft_transcendence\n4- Write a `.env` file on `/backend` and `/frontend` like the `.env.example`(s) to use your very own configurations  \n5- Run the containers\n\n    docker-compose up --build\n\n## Useful links  \n\n**General**  \n[Web Development 10min Overview](https://youtu.be/5YDVJaItmaY)  \n[100+ Web Development Things you Should Know](https://youtu.be/erEgovG9WBs)  \n\n[Frontend Overview](https://youtu.be/WG5ikvJ2TKA)  \n[Backend Overview](https://youtu.be/XBu54nfzxAQ)  \n\n[JavaScript 101](https://youtu.be/lkIFF4maKMU)  \n[Arrow functions in JavaScript](https://youtu.be/kzzkrhzGpkg)  \n[JavaScript Promises in 10 Minutes](https://youtu.be/DHvZLI7Db8E)  \n[JavaScript Promises in 10 Seconds](https://youtu.be/RvYYCGs45L4)  \n[Async Await and Promises](https://youtu.be/vn3tm0quoqE)  \n\n**NestJS**  \n[NestJS explained in 100 seconds](https://www.youtube.com/watch?v=0M8AYU_hPas)  \n[NestJS Tutorial for Beginners](https://www.youtube.com/watch?v=oU5Di3be-Sk\u0026list=PLS1QulWo1RIbihafA6GlwyvmwkHshmVyh\u0026pp=iAQB)  \n[Custom Decorators NestJS Docs](https://docs.nestjs.com/custom-decorators)  \n[Serve Static NestJS Docs](https://docs.nestjs.com/recipes/serve-static)  \n[Official Docs](https://docs.nestjs.com/)  \n\n**User Auth**  \n[Introduction to OAuth 2.0](https://www.digitalocean.com/community/tutorials/an-introduction-to-oauth-2)  \n[Session vs Token Authentication in 100 Seconds](https://www.youtube.com/watch?v=UBUNrFtufWo)  \n[Session vs Token based authentication](https://www.geeksforgeeks.org/session-vs-token-based-authentication/)  \n[NestJS Tutorial - Setting up Passport, OAuth2, TypeORM, Sessions, Session Store, Database](https://www.youtube.com/watch?v=vGafqCNCCSs)  \n[Introduction to JWT](https://jwt.io/introduction/)  \n[JWT Authentication best practices](https://blog.logrocket.com/jwt-authentication-best-practices/)  \n[JWT usage vs. Session](https://stackoverflow.com/questions/43452896/authentication-jwt-usage-vs-session)  \n[JWT vs. Opaque tokens](https://zitadel.com/blog/jwt-vs-opaque-tokens)  \n[Passportjs serializerUser and deserializeUser](https://stackoverflow.com/questions/29066348/passportjs-serializeuser-and-deserializeuser-execution-flow)  \n[2FA with Google](https://dev.to/hahnmatthieu/2fa-with-nestjs-passeport-using-google-authenticator-1l32)  \n[NestJS passport docs](https://docs.nestjs.com/recipes/passport)  \n\n**Chat \u0026 Game (WebSockets/Socket.IO)**  \n[A Beginner's Guide to WebSockets](https://www.youtube.com/watch?v=8ARodQ4Wlf4)  \n[WebSockets in 100 Seconds \u0026 Beyond with Socket.io](https://www.youtube.com/watch?v=1BfCnjr_Vjg)  \n[NestJS WebSockets Tutorial Playlist](https://www.youtube.com/watch?v=0zyYhm5MjJ4\u0026list=PLBHzlq7ILbsaL1sZxJIxrc4ofSPAMSTzr\u0026pp=iAQB)  \n[Full Socket.io and React.js Online Multiplayer Tic-Tac-Toe Game | Socket.io From Zero To Hero](https://www.youtube.com/watch?v=aA_SdbGD64E)  \n\n**Database**  \n[SQL explained in 100 seconds](https://youtu.be/zsjvFFKOm3c)  \n[7 Databases Overview](https://youtu.be/W2Z7fbCLSTw)  \n[Dockerhub Postgres image](https://hub.docker.com/_/postgres/)  \n[How to Use the Postgres Docker Official Image](https://www.docker.com/blog/how-to-use-the-postgres-docker-official-image/)  \n[PostgreSQL CLI Cheat Sheet](https://tomcam.github.io/postgres/)  \n[PostgreSQL Official Docker Image Docs](https://github.com/docker-library/docs/blob/master/postgres/README.md)  \n[Difference between one-to-many and many-to-one](https://stackoverflow.com/questions/4601703/difference-between-one-to-many-and-many-to-one-relationship)  \n\n**Adminer**  \n[Definition](https://en.m.wikipedia.org/wiki/Adminer)  \n[What is Adminer and how to use it](https://kinsta.com/blog/adminer/#what-is-adminer)  \n[Connection Adminer to Postgresql](https://www.reddit.com/r/docker/comments/g77ldf/connect_adminer_to_postgresql/)  \n[Setup Adminer with docker for database managment](https://dev.to/codewithml/setup-adminer-with-docker-for-database-management-4dd2)  \n\n**Gluing the pieces together**  \n[NestJS, TypeORM and PostgreSQL full example development and setup](https://medium.com/@gausmann.simon/nestjs-typeorm-and-postgresql-full-example-development-and-project-setup-working-with-database-c1a2b1b11b8f)  \n[Setting up NestJS with PostgreSQL](https://blog.devgenius.io/setting-up-nestjs-with-postgresql-ac2cce9045fe)  \n\n\n---\nMade by Nuno Carvalho (Kuninoto) | nnuno-ca@student.42porto.com  \n\u003cdiv id=\"badge\"\u003e \u003ca href=\"https://www.linkedin.com/in/nuno-carvalho-218822247\"/\u003e \u003cimg src=\"https://img.shields.io/badge/LinkedIn-blue?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" alt=\"LinkedIn Badge\"/\u003e\u0026nbsp;\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuninoto%2F42_ft_transcendence","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkuninoto%2F42_ft_transcendence","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuninoto%2F42_ft_transcendence/lists"}