Skip to content

Latest commit

 

History

History
executable file
·
177 lines (133 loc) · 6.2 KB

README.md

File metadata and controls

executable file
·
177 lines (133 loc) · 6.2 KB

🔑 PassOP: Your Password Manager 🚀

Hi there, Secure your online life with PassOP!

🌟 Stars 🍴 Forks 🐛 Issues 🔔 Open PRs 🔕 Close PRs
Stars Forks Issues Open Pull Requests Close Pull Requests

Overview 📌

  • 🔒 **PassOP** is a simple and secure password manager built with React that allows users to save, view, edit, and delete their passwords.
  • 💡 It helps you manage your passwords efficiently and securely using modern encryption techniques.

Features

  • 💾 Add Password: Save a new password with a website URL, username, and password.
  • 📝 Edit Password: Update an existing password easily.
  • Delete Password: Remove any saved password you no longer need.
  • 📋 Copy to Clipboard: Quickly copy website URLs, usernames, and passwords to your clipboard.
  • 👁️ Show/Hide Password: Toggle visibility of passwords for added convenience.

Open-Source-Programmes 🤝

This project is now OFFICIALLY accepted for

GSSOC
HACTOBERFEST

Back To Top

Getting Started 🚀

Prerequisites

Ensure you have the following installed:

  • Node.js (version 14.x or higher)
  • npm (Node package manager)
  • Vite (for running the React front-end)
  • MongoDB (local or cloud instance)

Installation

1. Clone the Repository:

git clone https://github.com/<your-username>/PassOP.git
cd PassOP

2. Setting Up the Backend:

  • Navigate to the backend folder:
cd backend
  • Install the required dependencies:
npm install
  • Set up your environment variables. Create or edit the .env file in the backend folder with the following:
    MONGO_URI=<your-mongodb-connection-string>
    DB_NAME=<your-database-name>
  • Run the backend server:
node server.js

3. Setting Up the Frontend:

  • Move back to the root directory:
cd ..
  • Install the front-end dependencies:
npm install
  • Run the React application using Vite:
npm run dev

4. Access the Application:

Now your password manager should be running locally!

Folder Structure 📂

PassOP/
├── backend/ # Backend Node.js application
│   ├── server.js # Main server file
│   ├── .env # Environment configuration (not included in repo)
│   ├── package.json # Backend dependencies
│   └── ... # Other backend files
├── frontend/ # React frontend application (using Vite)
│   ├── src/ # React components and files
│   ├── public/ # Public static files
│   ├── package.json # Frontend dependencies
│   └── vite.config.js # Vite configuration file
├── README.md # This file
└── ...

Contributing ⭐

We welcome all contributions! Read our CONTRIBUTING.md to get started building! 🛠️

Code of Conduct 📜

Please make sure to review and follow the project's Code of Conduct when contributing.


Project Admin ⚡

Adarsh

Contributors

Big thanks to all the contributors who have helped make Passop a better platform! 🎉

Back To Top