{"id":19519097,"url":"https://github.com/notsooshariff/password-manager","last_synced_at":"2026-02-12T08:33:27.404Z","repository":{"id":200595885,"uuid":"705660814","full_name":"NotSooShariff/password-manager","owner":"NotSooShariff","description":"A password manager application and a complete user data leak prevention system developed for users who want to self-host their password managers on their own infrastructures rather than giving the control over to a third party","archived":false,"fork":false,"pushed_at":"2024-12-21T15:37:30.000Z","size":62584,"stargazers_count":3,"open_issues_count":13,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T09:36:07.286Z","etag":null,"topics":["eslint","firebase","firebase-auth","nextjs","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NotSooShariff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-16T12:59:57.000Z","updated_at":"2024-11-04T16:01:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"3a7cfb7a-58d0-4502-a771-375a33454e32","html_url":"https://github.com/NotSooShariff/password-manager","commit_stats":null,"previous_names":["notsooshariff/password-manager"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NotSooShariff%2Fpassword-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NotSooShariff%2Fpassword-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NotSooShariff%2Fpassword-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NotSooShariff%2Fpassword-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NotSooShariff","download_url":"https://codeload.github.com/NotSooShariff/password-manager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250953347,"owners_count":21513300,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["eslint","firebase","firebase-auth","nextjs","typescript"],"created_at":"2024-11-11T00:16:18.867Z","updated_at":"2026-02-12T08:33:22.382Z","avatar_url":"https://github.com/NotSooShariff.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## 🔐 Monolith Password Manager Documentation\n\n### 1. Introduction\n\n#### Overview\nMonolith is a password manager application and a complete user data leak prevention system developed for users who either want to self-host their password managers on their infrastructures rather than giving the control over to a third party or for organizations or people who aren't as tech-savvy and want to take charge of their digital security and privacy. It allows users to securely store and manage their passwords. This documentation provides a guide on how to use the Monolith application.\n\nYou can watch an in-depth explanation of this project here:\n\nhttps://github.com/NotSooShariff/password-manager/assets/93514938/9a4ecf20-a898-4ea1-831f-a469b16069ff\n\n📽️ Find it on YouTube: https://www.youtube.com/watch?v=Tbqcxu5fYGg\n\n#### Features\n- User authentication using Firebase\n- Docker container for database deployment\n- Secure password storage\n- Password generation\n- Password retrieval\n- Password management\n\n#### Tech Stack\n- NextJS\n- TypeScript\n- TailwindCSS\n- Firebase\n- Docker\n- Snyk\n\n### Components / Solution Infrastructure\n\nThese are the four components of our solution (and where to find them):\n![Schematic](public/solution-infrastructures.png)\n\n\n### 2. Getting Started\n\n#### Prerequisites\nBefore you begin, ensure you have the following prerequisites installed:\n- [Node.js \u0026 npm (Node Package Manager)](https://nodejs.org/en/download)\n- [Git](https://git-scm.com/downloads)\n- [Docker](https://docs.docker.com/desktop/install/windows-install/) \n- [Firebase account](https://console.firebase.google.com/)\n- [Make](https://gnuwin32.sourceforge.net/packages/make.htm) (Optional) \n- A hosting provider (Optional)\n  \n\n#### Installation\n1. Clone the Monolith repository from GitHub. Using the following command:\n   ```\n    git clone https://github.com/NotSooShariff/Password-Manager.git\n   ```\n2. Navigate to the project directory using the following commands:\n   ```\n    cd Password-Manager\n    ```\n3. Install dependencies using:\n   ```\n    npm install\n    ```\n4. Pull the database from docker:\n   ```\n    docker pull notsooshariff/mono-db\n    ```\n\n### 3. User Authentication\n\n#### Firebase Setup\n- Create a Firebase project at [Firebase Console](https://console.firebase.google.com/).\n- Obtain Firebase API Keys (apiKey, authDomain, projectId, etc.).\n- Use the `.env.template` to create a `.env.local` and paste all your API Keys there so that the app can access these variables locally. \n- Once you have set this up, you will be able to use Firebase OAUTH to log in to your Application.\n\n### 4. Application Structure\n\n#### Project Directory\n-  The application follows a typical NextJS project's structure with the latest version \n\n## Getting Started\n\nFirst, Get your database up and running:\n```\n docker run -d --name my-mongodb-container -p 5000:5000 notsooshariff/mono-db\n```\n\nOnce your database is running and your Firebase keys have been configured, run the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n# or\nbun dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the website live.\n\n# License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](https://github.com/NotSooShariff/password-manager/LICENSE.md) file for details.\n\n# Contributions\n\nContributions are welcome! Feel free to fork the repo and issue a pull request to improve this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotsooshariff%2Fpassword-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnotsooshariff%2Fpassword-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotsooshariff%2Fpassword-manager/lists"}