hanif-ali / devresources

One destination for all the developer's learning resources.

DevResources

One destination for all the developer's learning resources.
Find all of your learning resources under one roof and add your own.

Live ✨

You can find the project live here 👈

Screenshot 📷

Features ℹ️

✔️ Responsive UI

✔️ Authentication System

✔️ Add / Update / Delete / View new resources of your own under specific categories

✔️ Searching/Browsing the existing resources

✔️ Top 3 watched resources

Add your own learning resource 🔥

1️⃣ Login to your account (if not create one)

2️⃣ Once logged in , click on the add icon which navigates to the add resources page

3️⃣ Enter Title , Resource URL , Categories (more than one if applicable) and hit save

4️⃣ Check whether your resource added is present in the Resources Added by You icon present at the top of the page or you may find it using the searchbox functionality

Set this project locally 💻

1. Go to the project repo and fork it by clicking "Fork" ( or Download the Zip file directly and start from the step 3 )
   

2. Open terminal / command prompt and Clone the project using git clone https://github.com/YOUR_USERNAME/devresources.git

3. Create a python3 virtual environment:

   $ python3 -m venv venv

   Or, use virtualenv:

   $ virtualenv venv

4. Activate the virtual environment:

   On Linux or Mac or any Unix based system-

   $ source venv/bin/activate

   On Windows-

   > venv\Scripts\activate
   

5. Now Install the dependecies:

   $ pip install -r requirements.txt

6. Creating local settings: Create a local_settings.py file in the same directory where your settings.py resides.

   Copy this code in your local_settings.py file -

   DEBUG = True
   

7. Creating .env file: Create a .env file in the same directory where your manage.py resides.

   Copy this text in your .env file -

   SECRET_KEY = 'secretkey'
   

8. Run the migrate command:

   $ python manage.py migrate

9. Now you are ready to go:

   Run the application

   $ python manage.py runserver

10. Optionally you can also add some dump data into your local database using this command:

    Add redacted dump data

    Note: Please run these commands in the same order it has been written here, either it will cause integrity error in your database.

    $ python manage.py loaddata fixtures/ResourceCategory.json
    
    $ python manage.py loaddata fixtures/Resource.json

Thanks