Skip to content

Mosope-ade/ShadowVault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 

Repository files navigation

ShadowVault πŸ›‘οΈ

ShadowVault is a state-of-the-art, fully client-side, offline-first credentials manager and private information vault. Built using React, TypeScript, and Tailwind CSS, it features military-grade zero-knowledge encryption powered entirely on-hardware by standard Web Cryptography APIs.


🎨 Creative Theme & User Experience

ShadowVault is built around an elegant, high-contrast Citadel Slate theme.

  • Atmospheric Visual Palette: Utilizes deep off-whites, carbon grays, slate backdrops, and glowing emerald highlights that replicate hard-key secure elements.
  • Responsive Adaptive Design: Stretches beautifully across desktop screens (presenting list-and-pane layouts side-by-side) and shifts smoothly into intuitive drawer-based interfaces on mobile screens.
  • Double Dismissibility: In mobile layouts, drawers are easily dismissed by tapping both the structural "X" toggle button or simply clicking outside onto the backdrop of the active work desk.

πŸš€ Key Functional Modules

1. Zero-Knowledge Cryptography Hardware

ShadowVault ensures your passwords never leave your system. All operations execute strictly client-side using industry-standard AES-GCM-256 encryption keys derived from your Master Password with high-entropy PBKDF2 salt stretching.

2. Integrated Biometric Touches

  • Encrypted biometric signature credentials can be enrolled directly via modern WebAuthn platform bindings.
  • Fully simulated fallback overlays are integrated natively, allowing you to test secure FaceID, TouchID, and Windows Hello hardware keys within sandbox iframe environments safely.

3. File System Folder Sync

  • Features continuous directory background sync powered by the modern File System Directory Access API.
  • When linked to a local folder, ShadowVault automatically compiles and writes an encrypted JSON container backup stream (shadowvault_autobackup.json) to your disk with every modification or edit!

4. Interactive Portal Sync Hub

  • Deploy credentials over temporary local sockets to sync databases securely between browser sessions or adjacent devices.
  • Automatically alerts and guards against collision risks during concurrent device pairings.

5. Multi-format CSV Migrating

  • Import existing account archives natively inside the memory sandbox from standard browser exports (Google Chrome, Mozilla Firefox, or custom database templates).

πŸ“œ Development & Setup

Prerequisite Installations

Ensure Node.js is installed on your local hardware.

# Install NPM dependencies
npm install

# Run the local development server (binds automatically to port 3000)
npm run dev

# Build the production distribution
npm run build

# Run the TypeScript linter checks
npm run lint

πŸ“¦ Native Multi-Platform Deployments

ShadowVault is structured to run as a high-performance native desktop or mobile application.

  • For building an Android installer package (APK),
  • Compiling a RedHat / Fedora server package (RPM), or
  • Assembling a Debian / Ubuntu system installer (DEB),

Please consult our comprehensive Multi-Platform Build Manual (BUILDING.md).


πŸ“„ License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for the full text of terms and conditions.

About

A safe and secure password manager.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors