Skip to content

Commit

Permalink
Updated Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
adityabagrii committed Jun 18, 2024
1 parent c373216 commit 3b99bf4
Showing 1 changed file with 85 additions and 5 deletions.
90 changes: 85 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,88 @@
# React + Vite
# YourPass

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
Welcome to **YourPass** - a secure and user-friendly password manager. This web application allows you to store, manage, and retrieve your passwords with ease. Built using MongoDB, ExpressJS, ReactJS, HTML, CSS, and JavaScript, YourPass ensures your password management is seamless across all devices.

Currently, two official plugins are available:
## Features

- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
- **Add Passwords**: Store passwords by entering the website URL, username, and password.
- **Copy to Clipboard**: Copy any field (URL, username, or password) to the clipboard with a single click.
- **Edit Passwords**: Update your stored passwords as needed.
- **Delete Passwords**: Remove passwords from the database with ease.
- **Responsive Design**: Enjoy a seamless experience on all screen sizes, from desktops to mobile devices.
- **Alerts with Toastify**: Get designed alerts for actions like adding, editing, or deleting passwords using the Toastify library.

## Demo

Check out the live demo of YourPass [here](https://adityabagrii.github.io/YourPass).

## Repository

You can find the source code for YourPass on GitHub [here](https://github.com/adityabagrii/YourPass).

## Getting Started

### Prerequisites

Ensure you have the following installed on your local machine:

- Node.js
- MongoDB

### Installation

1. **Clone the repository:**

```sh
git clone https://github.com/adityabagrii/YourPass.git
cd YourPass
```

2. **Install dependencies:**

```sh
npm install
```

3. **Set up environment variables:**

Create a `.env` file in the root directory and add the following:

```env
MONGO_URI=your_mongodb_connection_string
PORT=your_port_number
```

4. **Run the server:**

```sh
npm start
```

5. **Navigate to the client directory and start the React app:**

```sh
cd client
npm install
npm start
```

6. **Open the app in your browser:**

Visit `http://localhost:3000` to see YourPass in action.

## Usage

- **Add a Password:**
- Click on "Add Password".
- Enter the website URL, username, and password.
- Click "Save".

- **Copy a Field:**
- Click on the copy icon next to the field you want to copy (URL, username, or password).

- **Edit a Password:**
- Click the edit icon next to the password entry you want to modify.
- Update the details and click "Save".

- **Delete a Password:**
- Click the delete icon next to the password entry you want to remove.

0 comments on commit 3b99bf4

Please sign in to comment.