https://github.com/crackspy/clip
Clip - Bookmark Manager built with Django that lets users securely save, organize, and manage bookmarks.
https://github.com/crackspy/clip
bookmark-manager clip django-project python-3 webapp
Last synced: 3 months ago
JSON representation
Clip - Bookmark Manager built with Django that lets users securely save, organize, and manage bookmarks.
- Host: GitHub
- URL: https://github.com/crackspy/clip
- Owner: crackspy
- Created: 2025-05-16T16:36:09.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-07-03T04:41:22.000Z (3 months ago)
- Last Synced: 2025-07-03T05:21:45.504Z (3 months ago)
- Topics: bookmark-manager, clip, django-project, python-3, webapp
- Language: HTML
- Homepage: https://nccb1crack.pythonanywhere.com/
- Size: 670 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Clip – Bookmark Manager
**Clip** is a full-stack bookmark manager web application built with **Django** (Python). It lets users securely store and organize favorite website links, mobile apps, desktop apps, etc., in the form of bookmarks—complete with names, descriptions, URLs, tags, and import/export functionality—while also providing an intuitive admin dashboard.
## 🌟 Key Features
### 🖥️ User Side
- 📑 Browse Saved Bookmarks.
- ✏️ Create / Edit / Delete Bookmarks.
- 🔍 Search & Filter
- 👤 **Profile Page**
- Import / Export Bookmarks via JSON File
### ⚙️ Admin Side
- 👥 Manage All Users
- 📂 Manage All Bookmarks
## 🛠️ Project Stack
- 🐍 **Python**
- 🌿 **Django**
- 🐘 **PostgreSQL**
- 🌐 **HTML**
- 🌬️ **Tailwind CSS**
- ✨ **JavaScript**
## 🛠️ Installation
Follow these steps to set up the project locally:
1. **Clone the Repository:**
```bash
git clone https://github.com/crackspy/Clip.git
cd clip
```
2. **Create a Virtual Environment:**
```bash
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. **Install Dependencies:**
```bash
pip install -r requirements.txt
```
> 🔄 **Use SQLite (development only)**
> In `clip/settings.py`, comment out the PostgreSQL `DATABASES` block and uncomment (or add) the SQLite configuration:
> ```python
> DATABASES = {
> 'default': {
> 'ENGINE': 'django.db.backends.sqlite3',
> 'NAME': BASE_DIR / 'db.sqlite3',
> }
> }
> ```
4. **Set Up Environment Variables:**
Create a `.env-dev` file in the project root:
```
DEBUG=""
ALLOWED_HOSTS=""
EMAIL_HOST_USER=""
EMAIL_HOST_PASSWORD=""
# for postgresql DB
DB_NAME=""
DB_USER=""
DB_PASSWORD=""
DB_HOST=""
DB_PORT=5432
```
5. **Apply Migrations:**
```bash
python manage.py makemigrations
python manage.py migrate
```
6. **Create Superuser (Admin Account):**
```bash
python manage.py createsuperuser
```
7. **Run the Development Server:**
```bash
python manage.py runserver
```
Visit: [http://127.0.0.1:8000](http://127.0.0.1:8000)
## 📦 Project Structure
```
├── accounts/ # User authentication & profile management
├── bookmark/ # Core bookmark app (models, views)
├── clip/ # Django project settings & URL configuration
├── db.sqlite3 # SQLite database file (development)
├── manage.py # Django management script
└── requirements.txt # Python dependencies
```
## 📜 License
This project is licensed under the **MIT License**. Feel free to use and modify it.
## 📞 Contact
For any queries or suggestions, contact:
- 🌐 Project GitHub: [https://github.com/crackspy/Clip](https://github.com/crackspy/Clip)
---