Transcendence is a web-based social gaming platform that allows users to:
- Register or log in using the 42Auth API or an email and username.
- Connect with friends and see their online status.
- Chat with friends using a built-in chat app.
- View friend profiles and game statistics.
- Play Ping Pong against friends online in real-time.
- Play Ping Pong locally against the computer or with another user at the same keyboard.
- Front-end: React with Bootstrap for a responsive and user-friendly interface.
- Back-end: Django for robust server-side logic and data management.
- Websocket Secure for efficient and secure real-time communication during online Ping Pong matches.
- Node.js and npm (or yarn) installed for front-end development.
- Python 3 and Django framework installed for back-end development.
- A 42Auth API client ID and secret (if using 42Auth for login).
Nothing to Install Manually
-
Set Env
- Create a local development environment by copying what inside
README.md
to.env
. - Update
.env
with your database connection details, 42Auth credentials (if applicable), and any other necessary settings.
- Create a local development environment by copying what inside
-
Start the Docker Container
./start
-
Choose From the Menu
*In Production Mode : This will typically run the server on
https://Your_Host_Name:443
. *In Development Mode : This will typically run the server onhttp://Your_Host_Name:80
.
- Open
https://Your_Host_Name:443
orhttp://Your_Host_Name:80
in your web browser. - Register or log in using the available methods.
- Add friends and view their online status.
- Choose a game mode: Play online with a friend, locally with another user, or against the computer.
- Chat with friends using the built-in chat app.
We welcome contributions to Transcendence! If you'd like to contribute, please fork the repository and submit a pull request. Before contributing, please review the project's contribution guidelines (if available).
MIT.