Share N Learn is a centralized, role-agnostic platform designed for students and faculty to securely upload, manage, and share academic resources. The platform supports a wide range of study materials and ensures controlled access for registered users.

• Provide a secure and scalable content-sharing platform for academic institutions
• Reduce reliance on informal and fragmented channels such as social media
• Enable efficient dissemination of coursework-related resources
• Lay the groundwork for future expansion into a full-fledged academic e-library

• Frontend: HTML, CSS, JavaScript

• Backend: Python, Django Framework

  • Django Documentation: https://docs.djangoproject.com/en/3.1/

The following instructions will help you set up the project locally for development and testing.

• Python 3.7 or later
• Git
• A code editor (VS Code, Sublime Text, or Atom recommended)

Download and install Python 3.7+ from the official site: https://www.python.org/downloads/

Ensure “Add Python to PATH” is selected during installation.

Verify installation:

python --version

Download Git from: https://git-scm.com/downloads

Fork the repository from GitHub, then clone your fork:

git clone https://github.com/<your-github-username>/sharenlearn.git
cd sharenlearn

Add the upstream repository:

git remote add upstream https://github.com/chiraag-kakar/sharenlearn.git

Install virtualenv:

pip install virtualenv

Create and activate the virtual environment:

virtualenv myvenv -p python3.7
myvenv\Scripts\activate

Deactivate when needed:

deactivate

Ensure the virtual environment is active, then run:

pip install -r requirements.txt

Apply migrations:

python manage.py makemigrations
python manage.py migrate

Create a superuser for admin access:

python manage.py createsuperuser

python manage.py runserver

The application will be available at: http://127.0.0.1:8000/

• Keep your local master branch in sync with upstream:

git pull upstream master

• Always create a feature branch for changes:

git checkout -b <feature-branch-name>

• Never commit directly to master

Contributions are welcome and appreciated.

Before contributing:

• Review the Contributing Guidelines
• Review the Code of Conduct

git checkout -b <your-branch-name>
git add .
git commit -m "Descriptive commit message"
git push origin <your-branch-name>

Open a Pull Request: https://github.com/chiraag-kakar/sharenlearn/pulls

For major changes, please open an issue first to discuss the proposal.

This project is licensed under the MIT License. See the LICENSE file for details.

Maintained by Chiraag Kakar