An open API service indexing awesome lists of open source software.

https://github.com/m-ezhil/say-circle

Say Circle is a social media web app where users can sign up, log in, and share their thoughts with a title and content. They can view othersโ€™ posts and manage their own with edit and delete options. Built with REST APIs and authentication, it showcases CRUD operations and relational database handling.
https://github.com/m-ezhil/say-circle

axios bootstrap flask javascript python rest-api sql

Last synced: 2 months ago
JSON representation

Say Circle is a social media web app where users can sign up, log in, and share their thoughts with a title and content. They can view othersโ€™ posts and manage their own with edit and delete options. Built with REST APIs and authentication, it showcases CRUD operations and relational database handling.

Awesome Lists containing this project

README

          

# ๐Ÿ’ฌ Say Circle - Social Quotes App

Say Circle is a simple and modern **social media web application** that allows users to **create accounts, log in, and share their thoughts** with a title and content. Users can view posts from others, as well as edit or delete their own posts. The app is designed for easy sharing and interaction in a clean, responsive interface.

---

## ๐Ÿš€ Features

- **User Registration & Login**: Secure JWT-based authentication.
- **Create & Manage Posts**: Share thoughts with a title and content, edit or delete your own posts.
- **View Community Posts**: Browse posts from all users.
- **Responsive UI**: Built with Bootstrap for mobile and desktop.
- **RESTful API**: Clean backend endpoints for all core actions.

---

## ๐Ÿ› ๏ธ Tech Stack

- **Backend**: Python, Flask, REST API
- **Database**: SQLite with SQLAlchemy ORM
- **Frontend**: HTML, CSS, Bootstrap, JavaScript, Axios
- **Authentication**: JWT (JSON Web Tokens)

---

## โšก Getting Started

1. **Clone the repository:**
```bash
git clone https://github.com/m-ezhil/Say-Circle.git
cd say-circle
```

2. **Set up a virtual environment:**
```bash
python -m venv venv
# Activate:
# On Mac/Linux:
source venv/bin/activate
# On Windows:
venv\Scripts\activate
```

3. **Install dependencies:**
```bash
pip install -r requirements.txt
```

4. **Run the app:**
```bash
python app.py
```

5. **Open in your browser:**
```
http://127.0.0.1:5050
```

---

## ๐Ÿ“‚ Project Structure

- `app.py` โ€” Main Flask application entry point
- `models/` โ€” SQLAlchemy models for users and posts
- `templates/` โ€” HTML templates (Jinja2)
- `static/` โ€” CSS, JS, and images
- `requirements.txt` โ€” Python dependencies

---

## ๐ŸŽจ UI Screenshots

![Login Image](static/screenshots/login.png)
![Home Page Image](static/screenshots/home.png)
![Add Post Image](static/screenshots/add_post.png)
![Edit Post Image](static/screenshots/edit_post.png)

---

## ๐Ÿ“ข Contributing

Pull requests and issues are welcome! Please open an issue to discuss any major changes.

---

## ๐Ÿ“ License

This project is licensed under