Skip to content

hallidayz/lockminds

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

29 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LockingMiNDS

Enterprise-Grade Password Manager with Zero-Trust Architecture

LockingMiNDS is a cross-platform password manager built with modern security principles, featuring quantum-resistant encryption, zero-trust architecture, and enterprise-grade authentication methods.

πŸš€ One-Click Installation

For Everyone (Recommended)

# Download and run - that's it!
npx lockminds@latest

For Developers

# Clone and install
git clone https://github.com/yourusername/lockminds.git
cd lockminds
npm install
npm run setup

That's it! No configuration needed. The app will:

  • βœ… Automatically generate secure keys
  • βœ… Set up the database
  • βœ… Start the server
  • βœ… Open in your browser

🎯 Quick Start

  1. Install: npx lockminds@latest
  2. Open: http://localhost:3001
  3. Create account: Set up your master password
  4. Start using: Add your first password entry

πŸ” Security Features

Zero-Trust Architecture

  • Client-side encryption/decryption only - No sensitive data ever stored in plaintext
  • AES-GCM encryption with 256-bit keys and authenticated encryption
  • PBKDF2 key derivation with 100,000 iterations and random salts
  • Random IVs for every encryption operation

Advanced Authentication

  • WebAuthn/FIDO2 support for passwordless authentication
  • Biometric authentication integration ready
  • TOTP (Time-based One-Time Password) generator
  • Risk-based authentication engine
  • OIDC federation support

Enterprise Features

  • Multi-device synchronization with encrypted cloud backup
  • Device management and trust verification
  • Audit logging and security monitoring
  • External system integrations for enterprise environments

πŸš€ Technology Stack

Frontend

  • React 18 with TypeScript
  • Wouter for routing
  • TanStack Query for state management
  • Shadcn/UI with Tailwind CSS
  • Framer Motion for animations

Backend

  • Express.js with TypeScript
  • Drizzle ORM with SQLite (auto-configured)
  • JWT authentication with RSA signing
  • WebAuthn server implementation
  • Rate limiting and security middleware

Security & Crypto

  • Web Crypto API for client-side encryption
  • Node.js Crypto for server-side operations
  • bcrypt for password hashing
  • jsonwebtoken for session management

πŸ“¦ Installation Options

Option 1: NPX (Easiest)

npx lockminds@latest

Perfect for trying out the app

Option 2: NPM Global

npm install -g lockminds
lockminds

Great for regular use

Option 3: Local Development

git clone https://github.com/yourusername/lockminds.git
cd lockminds
npm install
npm run setup

Best for developers

Option 4: Docker

docker run -p 3001:3001 lockminds/lockminds

Perfect for servers

🎯 Usage

Getting Started

  1. Create Master Account - Set up your primary authentication
  2. Add Your First Entry - Store login credentials or payment cards
  3. Configure Settings - Set up backup, sync, and security preferences
  4. Install Browser Extension - For seamless password autofill (coming soon)

Key Features

  • Password Generation - Create strong, unique passwords
  • Secure Storage - All data encrypted before storage
  • Quick Search - Find entries instantly
  • Category Organization - Organize by type or custom tags
  • Backup & Sync - Multi-device synchronization with encryption

πŸ›‘οΈ Security Principles

Zero-Trust Design

  • No plaintext storage - All sensitive data encrypted client-side
  • Minimal server trust - Authentication backends verify identity only
  • End-to-end encryption - Data encrypted before transmission
  • Forward secrecy - Each session uses unique encryption parameters

Threat Model Protection

  • Data breach protection - Encrypted data is useless without master password
  • Network interception - All data encrypted in transit
  • Malicious server - Server cannot access vault contents
  • Device compromise - Local data encrypted at rest

πŸ”§ Development

Project Structure

lockminds/
β”œβ”€β”€ client/src/           # React frontend
β”‚   β”œβ”€β”€ components/       # UI components
β”‚   β”œβ”€β”€ lib/             # Utilities and encryption
β”‚   └── pages/           # Application pages
β”œβ”€β”€ server/              # Express backend
β”‚   β”œβ”€β”€ middleware/      # Authentication & security
β”‚   β”œβ”€β”€ routes/          # API endpoints
β”‚   └── services/        # Business logic
β”œβ”€β”€ shared/              # Common types and schemas
β”œβ”€β”€ install.js           # Automated setup script
└── package.json         # Dependencies and scripts

Available Scripts

  • npm run setup - Automated installation and configuration
  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run start - Start production server
  • npm run db:push - Sync database schema

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new features
  5. Submit a pull request

πŸ“‹ Roadmap

Phase 1 (Current)

  • βœ… Zero-trust encryption implementation
  • βœ… Core password management features
  • βœ… Modern React UI with dark theme
  • βœ… WebAuthn authentication foundation
  • βœ… One-click installation

Phase 2 (Planned)

  • Browser extension for autofill
  • Mobile applications (iOS/Android)
  • Advanced import/export features
  • Team sharing and collaboration

Phase 3 (Future)

  • Hardware security key integration
  • Advanced threat detection
  • Enterprise SSO integration
  • Compliance reporting tools

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

🀝 Support

For support, feature requests, or bug reports:

πŸ”’ Security Disclosure

Found a security vulnerability? Please report it responsibly:


Built with security first. Your data, your control.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors