Chai Tweet — Django Project

About   |   Features   |   Technologies   |   Architecture   |   Requirements   |   Starting   |   License   |   Author

🎯 About

Chai Tweet is a full-stack Twitter-inspired web application built with Django. Users can register, log in, create tweets with optional photo uploads, edit and delete their own tweets, and search tweets by text with keyword highlighting — all rendered server-side using Django templates and Bootstrap 5.

✨ Features

✔️ User Registration & Login with Django Auth
✔️ Create, Edit, Delete Tweets (ownership protected)
✔️ Optional Photo Upload per Tweet
✔️ Search Tweets by Text with Green Keyword Highlight
✔️ Login Required for Protected Actions
✔️ Responsive UI with Bootstrap 5
✔️ Secure Secret Key via python-dotenv

🚀 Technologies

The following tools were used in this project:

• Python 3
• Django 6
• Bootstrap 5
• SQLite
• Pillow
• python-dotenv

🏗️ Architecture

Django_Project__1/
├── chaiheadq/               # Project config
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── tweet/                   # Main app
│   ├── migrations/
│   ├── templates/
│   │   ├── index.html
│   │   ├── tweet_list.html
│   │   ├── tweet_form.html
│   │   ├── tweet_confirm_delete.html
│   │   └── search_results.html
│   ├── templatetags/
│   │   └── custom_filters.py   # Keyword highlight filter
│   ├── models.py            # Tweet model
│   ├── views.py             # CRUD + search views
│   ├── forms.py             # TweetForm, UserRegistrationForm
│   └── urls.py
├── templates/
│   ├── layout.html          # Base template
│   └── registration/        # Login, logout, register
├── .env                     # Secret key (not pushed to GitHub)
├── .gitignore
├── requirements.txt
└── manage.py

✅ Requirements

Before starting 🏁, you need to have Git and Python 3 installed.

🏁 Starting

# Clone this project
$ git clone https://github.com/Arnav-Naive/Django_Project__1

# Access
$ cd Django_Project__1/chaiheadq

# Create virtual environment
$ python -m venv .venv

# Activate (Windows)
$ .venv\Scripts\activate

# Activate (Mac/Linux)
$ source .venv/bin/activate

# Install dependencies
$ pip install -r requirements.txt

# Create .env file in root and add:
# SECRET_KEY=your-secret-key
# DEBUG=True

# Run migrations
$ python manage.py migrate

# Start the server
$ python manage.py runserver

# The server will initialize at http://127.0.0.1:8000/tweet/

📝 License

This project is under license from MIT. For more details, see the LICENSE file.

 

Back to top