markdown 📝 Django Mini Blog

A beginner-friendly Django blog app built while learning Django step by step.
Features include:

• User authentication (register/login/logout)
• Create, Read, Update, Delete (CRUD) posts
• Bootstrap styling
• Pagination
• Django admin for post management

🚀 Getting Started

1. Clone the repo

git clone https://github.com/YOUR-USERNAME/django-blog.git
cd django-blog

2. Create a virtual environment

python -m venv venv
# activate venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

(Optional: you can create requirements.txt with pip freeze > requirements.txt)

4. Run migrations

python manage.py migrate

5. Create a superuser

python manage.py createsuperuser

6. Run the server

python manage.py runserver

Now open your browser at: http://127.0.0.1:8000/ 🎉

---

📂 Project Structure

mysite/
│── manage.py
│── db.sqlite3
│── requirements.txt
│── blog/                # blog app
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   └── templates/blog/
│
├── templates/           # base templates
├── static/              # static files (css, js, images)
└── media/               # user-uploaded files

---

✨ Future Improvements

• Add comments feature
• Add tags or categories
• Deploy to Heroku/Railway

---

📜 License

MIT License

🔹 Steps to add it

1. In VS Code, create a file named README.md in your project root.
2. Paste the above content (edit YOUR-USERNAME/django-blog.git to your actual GitHub repo link).
3. Save, then push it to GitHub:

   git add README.md
   git commit -m "Add README file"
   git push