Reddit Clone — JavaFX Edition

🍊 Fully featured desktop version of the social website Reddit developed using Java 🍊

📚 Table of Contents

• About the Project
• Getting Started
• Features
• Future Upgrades
• Contributing
• License
• Contact

About The Project 🎨

This project is a desktop-based Reddit clone built with JavaFX. It simulates the core Reddit experience in an interactive Java GUI application. This version features creating and managing accounts, creating and editing subreddits, uploading posts, sending private messages, upvoting & downvoting and adding comments.

Built With

• 
• 

Back to Top

Getting Started 🧩

To get a local copy up and running, follow these steps:

Requirements

• JDK 17+
• JavaFX SDK (properly configured in your IDE)
• Any Java IDE (e.g., IntelliJ IDEA, Eclipse)

How to Run

1. Clone the repository

   git clone https://github.com/TheDanielTp/Reddit-Clone-JavaFX
   

2. Open in your IDE

   • Import the project as a Gradle, Maven, or JavaFX project (depending on how it's set up).
   • Make sure that JavaFX libraries are properly configured in your project settings or build file.

3. Run the app

   • Use your IDE’s Run feature to launch the main class.
   • The JavaFX GUI should appear with the front page.

Back to Top

Features 🛠

• User management system

  • Create accounts, login & logout and edit your profile info. Database handles everything.

• Subreddits

  • Create, join & manage communities. Subreddit owners can remove members, promote members to admins and edit Subreddit's info.

• Posts & Comments

  • Create posts in Subreddits. Users can Upvote or Downvote posts and add comments. Comments can also be upvoted or downvoted. The original posters can edit or delete their posts.

• Private Messages

  • Send and receive direct messagess within the app.

Back to Top

Future Upgrades 🚀

• Notification system
• Media attachments (images/videos)
• Moderation tools for subreddit admins
• Chat or group messaging
• Backend integration with cloud storage

Back to Top

Contributing 🤝

Contributions are what make the open source community such a great learning environment! If you have ideas for improvements, feel free to fork and submit a pull request.

Steps to contribute:

• Fork the repo
• Create a feature branch (git checkout -b feature/my-feature)
• Commit your changes (git commit -m "Add my feature")
• Push to the branch (git push origin feature/my-feature)
• Open a pull request

Back to Top

License 📄

Distributed under the MIT License. See LICENSE for more info.

Back to Top

Contact ☎️

My Email - [email protected]

Project Link: https://github.com/TheDanielTp/Reddit-Clone-JavaFX

Back to Top