Skip to content

amusement-lab/password-manager-server

Repository files navigation

Password Manager

Just deploy your own password manager. Just trust yourself. Very simple server for basic password manager. Open for contribute. Your a front end dev? You can check and contribute to password manager client.

Some excellent features:

  • Open API implementation (doc and ui)
  • Implements many basic cryptographic concepts
  • Applying the Zero Knowledge principle
  • Implement integration testing via vitest
  • Use Typescript

Run This Project

  1. Install package
pnpm install
  1. (Optional) Start Docker containers for the database
docker-compose up -d
  1. Setup your .env. If you use docker, the settings are in accordance with the config in docker-compose.yml
cp.env.example.env
cp.env.test.example.env.test // for test environment
  1. Setup the prisma ORM
pnpm prisma migrate dev
pnpm prisma generate
  1. Run the project
pnpm dev
  1. You can access the open api documention at
http://localhost:3000/open-api

NodeJS Version Environment for development

  • Typescript = v6.0.2
  • NodeJS = v24.14.0 or v22.22.2
  • PNPM = v10.33.0

Some further developments, if you want to contribute, here the top priority

  • The error handler still doesn't cover all errors (critpyo and zod errors don't yet)
  • For now, you can only save the password, but later you can save bank cards, notes, addresses and documents
  • Test cases are still few, only positive tests, many negative tests are needed to validate the error
  • Implement export import feature for password backup
  • Implement new id template [prefix]_[id]

Refrence

About

Just deploy your own password manager. Just trust yourself.

Topics

Resources

Stars

Watchers

Forks

Contributors