NepSocial — Full-Stack Django Social Networking Platform

NepSocial is a modern, responsive full-stack social media application built with Django and styled with a clean, solid UI design system. It allows users to share photos, follow creators, discover trending content, and manage their personal profiles.

---

🌟 Key Features

• User Authentication: Secure signup and sign-in workflows with real-time field validation and password toggling.
• Home Feed: Responsive multi-column layout displaying dynamic post streams from followed users and community creators.
• Media Uploads & Lightbox: Quick post publishing modal with instant client-side photo previews and full-screen image zoom.
• Interactions: Interactive post liking with live counters and quick profile link sharing.
• Creator Profiles: Dynamic profiles featuring cover headers, avatar badges, live follower/following metrics, and responsive photo galleries.
• Search & Discovery: Keyword and username search across the creator directory with direct follow actions.
• Account Customization: Edit bio with character limits, location tags, and interactive avatar updates.

---

🛠️ Tech Stack

• Backend: Python 3, Django 5.0, Django REST Framework
• Frontend: HTML5, Django Template Language, Tailwind CSS, FontAwesome 6
• Database: SQLite3 (Production-ready for PostgreSQL / MySQL)
• Image Processing: Pillow

---

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/nirajan-khatiwada/NepSocial.git
cd NepSocial

2. Set Up Virtual Environment

# Windows
python -m venv .venv
.venv\Scripts\activate

# macOS / Linux
python3 -m venv .venv
source .venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

4. Environment Configuration

# Copy the example environment file
cp .env.example .env

5. Run Migrations & Create Superuser

python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

Open http://127.0.0.1:8000/ in your browser.

---

📂 Project Structure

├── core/
│   ├── models.py       # Profile, Post, Follower, Like models
│   ├── views.py        # Feed, profile, upload, auth views
│   ├── urls.py         # App URL routes
│   └── templates/      # Base, feed, profile, settings, auth templates
├── socialmedia/
│   ├── settings.py     # Django project configuration
│   └── urls.py         # Root routing & static/media handlers
├── media/              # User-uploaded images & avatars
├── static/             # Static assets
└── requirements.txt    # Project dependencies