Password Manager

A secure password manager application built with FastAPI (Python) and React.js. This application allows users to safely store and manage their passwords with features like category organization, password generation, & secure master password authentication.

• 🔐 Master password authentication
• 📂 Password categorization
• 🔄 Password generation
• 🔍 Search and filter capabilities
• 📱 Responsive design
• 💾 Local session storage
• 🔒 Secure password storage

• FastAPI (Python 3.8+)
• SQLite database
• uvicorn ASGI server
• Python packages:
  • fastapi
  • uvicorn
  • sqlite3 (built-in)
  • python-multipart
  • python-jose[cryptography]
  • passlib[bcrypt]

• React.js
• Tailwind CSS
• shadcn/ui components
• Radix UI primitives
• Local/Session Storage for auth persistence

• Python 3.8 or higher
• Node.js 14 or higher
• npm or yarn

1. Navigate to the server directory:

cd server

2. Create and activate a virtual environment:

python -m venv venv

# On Windows
venv\Scripts\activate

# On macOS/Linux
source venv/bin/activate

3. Install dependencies:

pip install -r requirements.txt

4. Run the server:

python main.py

The server will start at http://localhost:8000

1. Navigate to the client directory:

cd client

2. Install dependencies:

npm install

3. Run the development server:

npm run dev

The client will start at http://localhost:5173

password-manager/
├── server/
│   ├── main.py
│   ├── requirements.txt
│   └── passwords.db
└── client/
    ├── src/
    │   ├── components/
    │   │   └── ui/
    │   ├── pages/
    │   │   └── PasswordManager.jsx
    │   ├── utils/
    │   │   └── authStorage.js
    │   ├── lib/
    │   │   └── utils.js
    │   ├── App.jsx
    │   └── main.jsx
    ├── public/
    ├── index.html
    ├── package.json
    ├── tailwind.config.js
    └── vite.config.js

• POST /auth/login - Login with master password
• POST /auth/change-master-password - Change master password

• GET /categories - Get all categories
• POST /categories - Create new category

• GET /passwords - Get all passwords
• POST /passwords - Create new password
• DELETE /passwords/{password_id} - Delete password
• GET /generate-password - Generate random password

• Password hashing using SHA-256
• Session-based authentication
• Secure password storage
• CORS protection
• Input validation
• Optional "Remember Me" functionality

Master Password: admin123

1. Fork the repository
2. Create a new branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

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

• FastAPI
• React.js
• Tailwind CSS
• shadcn/ui
• Radix UI

• Add dockerfile
• Make desktop app
• Password strength meter
• Export/Import functionality
• Password sharing capabilities
• Two-factor authentication
• Password expiry notifications
• Automatic password rotation
• Audit logs
• Browser extension