🔐 Password Vault Pro

A modern, feature-rich password manager with beautiful dark UI

Features • Live Demo • Installation • Screenshots • Technologies • Architecture

---

🎯 Overview

Password Vault Pro is a secure, offline password manager with a stunning dark-themed interface. The desktop application is built with Python and Tkinter, while the interactive web demo uses HTML5, CSS3, and JavaScript. It offers enterprise-level features like master password protection, password recovery options, smart service categorization, and password strength analysis.

---

🚀 Live Demo

Experience Password Vault Pro directly in your browser! No installation required.

Demo Password: demo123

---

✨ Features

🎨 Modern Dark UI

• Beautiful gradient dark theme
• Smooth animations and hover effects
• Intuitive tabbed interface
• Responsive design

🔒 Security Features

Feature	Description
Master Password	SHA-256 hashed protection
Password Strength Meter	Real-time strength analysis
Password Recovery	Email & hint-based recovery
Local Storage	All data stored locally—no cloud

📂 Smart Organization

• 8 Pre-built Categories: Social Media, Streaming, Email, Development, Cloud Storage, Finance, Shopping, Work
• 50+ Service Suggestions: Quick-add buttons for popular services
• Search & Filter: Instantly find any password
• Category Browser: Visual grid of all supported services

⚡ Quick Actions

• One-click service addition (Gmail, GitHub, Netflix, etc.)
• Auto-category detection
• Bulk delete with confirmation
• Password visibility toggle

---

📦 Installation

Prerequisites

• Python 3.7 or higher
• Tkinter (included with most Python installations)

Quick Start

# Clone the repository
git clone https://github.com/tharun-ship-it/password-vault-pro.git
cd password-vault

# Run the application
python src/vault.py

Install as Package

pip install -e .
password-vault  # Run from anywhere

---

📸 Screenshots

Login Screen

Secure master password authentication with password recovery options.

Add Password Tab

Quick-add buttons, form validation, and real-time password strength indicator.

My Passwords Tab

Searchable list with category tags, view/delete actions, and bulk operations.

Categories Browser

Visual grid of 50+ services organized into 8 categories for quick addition.

---

🛠 Technologies

This project uses two implementations to showcase both desktop and web development skills:

Desktop Application (Python)

Technology	Purpose
	Core application logic
	GUI framework
hashlib	SHA-256 password hashing
json	Data storage
pathlib	Cross-platform file handling

Live Demo (Web)

Technology	Purpose
	Page structure
	Styling & animations
	Interactive functionality

Why Two Implementations?

• Desktop App: Demonstrates Python skills, OOP, GUI development, security best practices
• Web Demo: Allows recruiters to try the app instantly without installation, showcases HTML/CSS/JS skills

---

🏗 Architecture

password-vault-pro/
├── src/
│   ├── __init__.py           # Package initialization (Python)
│   └── vault.py              # Main desktop app - 700+ lines (Python + Tkinter)
├── tests/
│   └── test_vault.py         # Unit tests (Python)
├── assets/
│   └── screenshot.png        # App screenshot
├── index.html                # Live web demo (HTML + CSS + JavaScript)
├── .github/
│   └── workflows/ci.yml      # CI/CD pipeline (YAML)
├── requirements.txt          # Dependencies (none!)
├── setup.py                  # Package config (Python)
├── pyproject.toml           # Modern Python config
├── LICENSE                   # MIT License
└── README.md                 # Documentation (Markdown)

Data Storage

~/.password_vault_pro/
├── config.json    # Master password hash, recovery email, hint
└── vault.json     # Stored credentials (JSON format)

Security Model

Component	Implementation
Master Password	SHA-256 hash (never stored plain)
Recovery Options	Email + Phone Number + Custom Hint
Password Display	Masked with 👁 eye toggle to reveal
Password Strength	Real-time meter (Weak → Excellent)
Storage	Local filesystem only (offline)

---

🧪 Testing

# Run unit tests
python -m pytest tests/ -v

# Run with coverage
python -m pytest tests/ --cov=src --cov-report=html

---

🛣 Roadmap

• Master password with recovery
• Password strength indicator
• Category-based organization
• Quick-add service buttons
• Search and filter
• Live web demo
• Password generator
• Export/import (CSV, JSON)
• Browser extension
• Mobile companion app

---

🤝 Contributing

Contributions are welcome! Please read the Contributing Guide first.

# Fork and clone
git clone https://github.com/YOUR_USERNAME/password-vault.git

# Create branch
git checkout -b feature/amazing-feature

# Commit and push
git commit -m 'Add amazing feature'
git push origin feature/amazing-feature

# Open Pull Request

---

📄 License

This project is licensed under the MIT License—see the LICENSE file for details.

---

👤 Author

Tharun Ponnam

• GitHub: @tharun-ship-it
• Email: tharunponnam007@gmail.com

---

⭐ If you find this project useful, please consider giving it a star!

• 🔗 Live Demo
• 🐛 Report Bug
• ✨ Request Feature