TweetHub 🐦📱

Welcome to TweetHub, a simple Django-based web application for posting and managing tweets! It's like social media, where users can share their thoughts and manage tweets with ease.

Features ✨

• Create, edit, and delete tweets.
• User authentication and profile management.
• Beautiful, responsive Bootstrap-powered UI.
• Search functionality to find tweets easily.
• Manage tweets with images and text.

---

Technologies Used 💻

• Python 3.x: The main programming language.
• Django: The web framework used for building this project.
• Bootstrap: For responsive and mobile-first design.
• SQLite: The database used for local development.

---

Installation 🔧

To run this project locally, follow these steps:

1. Clone the repository

First, clone the repository to your local machine:

git clone https://github.com/your-username/tweethub.git
cd tweethub

2. Set up a virtual environment (venv)

Create and activate a virtual environment to manage your dependencies:

On macOS/Linux:

python3 -m venv venv
source venv/bin/activate

On Windows:

python -m venv venv
venv\Scripts\activate

3. Install dependencies

Install the required packages from the requirements.txt file:

pip install -r requirements.txt

4. Configure environment variables

Create a .env file in the root directory to store sensitive information like your Django secret key.

Example .env file:

SECRET_KEY=your-secret-key
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1

5. Apply migrations

Run the database migrations to set up the database schema:

python manage.py migrate

6. Create a superuser (optional)

To access the Django admin panel, you can create a superuser:

python manage.py createsuperuser

7. Run the development server

Start the Django development server:

python manage.py runserver

Now, open your browser and go to http://127.0.0.1:8000/ to access the project.

---

Usage 🚀

1. Posting a Tweet

• Click on Create Tweet and fill in the details.
• You can also upload an image with the tweet.
• Submit the form, and your tweet will be live!

2. Editing or Deleting a Tweet

• Go to the list of tweets, and click the Edit or Delete buttons to manage your posts.

3. Searching Tweets

• Use the search bar on the home page to search tweets based on the content.

---

Contributing 🛠

We welcome contributions to improve this project! If you'd like to contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bugfix:

   git checkout -b your-feature-branch

3. Commit your changes and push them to your fork:

   git commit -m "Add new feature"
   git push origin your-feature-branch

4. Submit a pull request, and we’ll review it as soon as possible!

---

Contact 📧

If you have any questions or suggestions, feel free to reach out:

• Email: jasoncobra3@gmail.com

---

Happy Coding! 😊

---