{"id":18247139,"url":"https://github.com/madhvi-n/django-reddit","last_synced_at":"2025-07-16T12:05:28.407Z","repository":{"id":127035032,"uuid":"532970281","full_name":"madhvi-n/django-reddit","owner":"madhvi-n","description":"A feature-rich Reddit clone built using Django for the backend and Angular for the frontend. This project allows users to create, interact, and engage in discussions within communities.","archived":false,"fork":false,"pushed_at":"2025-05-29T06:56:21.000Z","size":2092,"stargazers_count":32,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-29T07:51:14.546Z","etag":null,"topics":["angular10","django","django-ci","django-reddit","djangorestframework","python","reddit-clone"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/madhvi-n.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-05T16:03:51.000Z","updated_at":"2025-05-29T06:56:18.000Z","dependencies_parsed_at":"2024-11-05T09:30:59.818Z","dependency_job_id":"fa7a2d05-07e0-4e0f-99b0-c53b7bc9deae","html_url":"https://github.com/madhvi-n/django-reddit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/madhvi-n/django-reddit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madhvi-n%2Fdjango-reddit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madhvi-n%2Fdjango-reddit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madhvi-n%2Fdjango-reddit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madhvi-n%2Fdjango-reddit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/madhvi-n","download_url":"https://codeload.github.com/madhvi-n/django-reddit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madhvi-n%2Fdjango-reddit/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265508108,"owners_count":23779076,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular10","django","django-ci","django-reddit","djangorestframework","python","reddit-clone"],"created_at":"2024-11-05T09:29:17.802Z","updated_at":"2025-07-16T12:05:27.591Z","avatar_url":"https://github.com/madhvi-n.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Django Reddit\n\n[![Django CI](https://github.com/madhvi-n/django-reddit/actions/workflows/django.yml/badge.svg)](https://github.com/madhvi-n/django-reddit/actions/workflows/django.yml)\n[![CodeQL](https://github.com/madhvi-n/django-reddit/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/madhvi-n/django-reddit/actions/workflows/github-code-scanning/codeql)\n[![Python](https://img.shields.io/badge/Python-3.12-blue?style=flat\u0026logo=python\u0026logoColor=white)](https://www.python.org/)\n[![Django](https://img.shields.io/badge/Django-3.1-brightgreen?style=flat\u0026logo=django\u0026logoColor=white)](https://www.djangoproject.com/)\n[![Django Rest Framework](https://img.shields.io/badge/Django_Rest_Framework-3.11-red?style=flat\u0026logo=django\u0026logoColor=white)](https://www.django-rest-framework.org/)\n[![Angular](https://img.shields.io/badge/Angular-10-blueviolet?style=flat\u0026logo=angular\u0026logoColor=white)](https://angular.io/)\n\nA **feature-rich Reddit clone** built using **Django** for the backend and **Angular** for the frontend. This project allows users to create, interact, and engage in discussions within communities.\n\n## 🚀 Features\n\n- **User Authentication**: Sign up, log in, and manage accounts securely.\n- **Create \u0026 Interact with Posts**: Standalone and group-based posts with threaded discussions.\n- **Community Features**: Users can create and join groups (public, private, or restricted).\n- **Engagement Mechanisms**: Upvote/downvote system for posts and comments.\n- **Social Interaction**: Follow users and posts.\n- **Content Moderation**: Report inappropriate content.\n- **Bookmarks \u0026 Saves**: Users can save their favorite posts.\n- **Invites \u0026 Membership Requests**: Manage group access through invites and requests.\n\n\n## 📸 Screenshots\n\n![Django Reddit Sign In Page](screenshots/image01.png?raw=true \"Django Reddit Sign In\")\n\n![Django Reddit Feed](screenshots/image02.png?raw=true \"Django Reddit Feed\")\n\n![Django Reddit Group](screenshots/image03.png?raw=true \"Django Reddit Group\")\n\n![Django Reddit User Feed](screenshots/image04.png?raw=true \"Django Reddit User Feed\")\n\n\u003cbr\u003e\n\n## 🔧 Requirements\n\n### Backend\n- Python 3.8+\n- virtualenv\n- WSL (Windows Subsystem for Linux)\n\n### Frontend\n- Angular 10.2.4 (or 10.2.5)\n- Node 10.13.x+\n\n\n## ⚙️ Installation\n\n### Backend Setup\n1. Clone the repository and navigate to the project directory:\n    ```bash\n    git clone https://github.com/madhvi-n/django-reddit.git\n    cd django-reddit\n    ```\n\n2. Create and activate a virtual environment:\n    ```bash\n    virtualenv venv\n    source venv/bin/activate  # For macOS/Linux\n    venv\\Scripts\\activate     # For Windows\n    ```\n\n3. Install dependencies:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n4. Set the **Django Secret Key**:\n    - Edit `reddit_clone/settings.py` and manually set a secret key.\n    - Or, export `SECRET_KEY` in your environment variables.\n\n5. Apply database migrations:\n    ```bash\n    python manage.py migrate\n    ```\n\n6. Run the development server:\n    ```bash\n    python manage.py runserver\n    ```\n\n    Visit **`http://127.0.0.1:8000/`** to access the app.\n\n\n\n### 🌐 Frontend Setup\n1. Navigate to the frontend directory:\n    ```bash\n    cd static/frontend/reddit-app\n    ```\n\n2. Install Angular dependencies:\n    ```bash\n    npm install\n    ```\n\n3. Run the frontend development server:\n    ```bash\n    ng serve\n    ```\n\n    Visit **`http://127.0.0.1:4200/`** to access the frontend.\n\n## 📝 API Documentation\n\nThe API documentation is available via **Swagger**:\n\n- **Swagger UI:** `http://127.0.0.1:8000/api/swagger/`\n- **Redoc:** `http://127.0.0.1:8000/api/redoc/`\n\n## ⚙️ Environment Variables\n\nCreate a `.env` file to store sensitive configuration details:\n\n```ini\nSECRET_KEY=your_secret_key\nDEBUG=True\nDATABASE_NAME=my_db\nDATABASE_USER=my_username\nDATABASE_PASSWORD=my_db_password\nDATABASE_HOST=localhost\nDATABASE_PORT=5432\n```\n\n\n## 📈 Management Commands\n\n### Generate Data in Django Shell\n```python\nfrom django.contrib.auth.models import User\nfrom posts.models import Post\nfrom groups.models import Group\n\nuser = User.objects.get(id=1)\npost = Post.objects.create(title=\"Sample Post\", content=\"Post content here\", author=user)\ngroup = Group.objects.create(name=\"Django\", description=\"Official Django community on Django Reddit\")\n```\n\n### Populate Dummy Data\n```bash\npython manage.py populate_users\npython manage.py populate_posts\npython manage.py populate_tags\npython manage.py populate_groups\n```\n\n\n## 💡 Notes\n- **Backend (Django) runs on WSL**\n- **Frontend (Angular) runs directly on Windows**\n\n\n## 📐 References\n- [How to Install Python 3.8 on Ubuntu 18.04](https://linuxize.com/post/how-to-install-python-3-8-on-ubuntu-18-04/)\n- [Installing Node.js on Windows](https://www.guru99.com/download-install-node-js.html)\n- [Official Angular 10 Installation Guide](https://v10.angular.io/guide/setup-local)\n- [Installing a Specific Version of Angular CLI](https://stackoverflow.com/questions/44759621/install-specific-version-of-ng-cli)\n- [Angular, Angular CLI, and Node.js Compatibility](https://stackoverflow.com/questions/60248452/is-there-a-compatibility-list-for-angular-angular-cli-and-node-js)\n\n### 🎉 **Happy Coding!** 🚀\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmadhvi-n%2Fdjango-reddit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmadhvi-n%2Fdjango-reddit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmadhvi-n%2Fdjango-reddit/lists"}