⚠️ Project is still under heavy development ⚠️

It is in a useable state but many features are missing!

DHub - Online Discussion Forum

DHub is an online discussion forum designed to bring people together to discuss a wide range of topics. It provides a platform for users to engage in meaningful conversations, share knowledge, and connect with like-minded individuals.
Visit DHub · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Contributing
4. License
5. Acknowledgments

About The Project

DHub was created from an assignment for my React Front-end development course. I find this is a great project so I upgrade and refine it to a fully fledged website with proper database and authentication. You can host your own DHub by following the instruction below. I hope you have a fun time using DHub!

(back to top)

Built With

• 
• 
• 

(back to top)

Getting Started

To set up DHub locally on your machine, follow these steps:

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

• npm

  npm install npm@latest -g

Installation

1. Prepare a MongoDB Database. You can create one free at MongoDB Atlas
2. Create an google OAuth consent screen
3. Sign up for Cloudinary
4. Clone the repo

   git clone https://github.com/your_username_/Project-Name.git

5. Install NPM packages

   npm install

6. Configure your environment variables

   MONGODB=<Your MongoDB connection string>
   OAUTH_GOOGLE_CLIENT_ID=<Your google oauth id>
   OAUTH_GOOGLE_CLIENT_SECRET=<Your google oauth secret id>
   NEXTAUTH_URL=<Your website deployment url>
   NEXTAUTH_SECRET=<Authentiation secret key>
   NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=<Cloudinary cloud name>
   

7. Start development with npm run dev or deploy it to a hosting with npm run build && npm run start.

(back to top)

Screenshots

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Acknowledgments

• Choose an Open Source License
• Img Shields
• Vercel
• React Icons

(back to top)