Skip to content

Repository files navigation

GHBanner

VaultCloud - Secure Password & Account Manager

A modern, secure password and account management application built with:

  • Frontend: React 19 + TypeScript + Vite (Cloudflare Pages)
  • Backend: Cloudflare Workers API
  • Database: Cloudflare D1

Features

🔐 Secure password storage with PGP encryption
📝 Encrypted notes management
👥 Multi-user support with role-based access
🔑 Multiple authentication methods (Password, Magic Link, FIDO2)
🔄 Share passwords and notes securely
🎨 Dark/Light theme support
🌍 Multi-language support (i18n)

Quick Start

Prerequisites

  • Node.js 18+
  • Cloudflare account
  • Wrangler CLI: npm install -g wrangler

Local Development

  1. Install dependencies

    npm install
  2. Set up environment

    cp .env.example .env.local
    cp .dev.vars.example .dev.vars
  3. Initialize D1 database (local)

    wrangler d1 create vaultcloud-db --local
    wrangler d1 execute vaultcloud-db --local --file=./worker/src/db/schema.sql
    wrangler d1 execute vaultcloud-db --local --file=./worker/src/db/seed.sql
  4. Start development servers

    Terminal 1 - Worker API:

    npm run worker:dev

    Terminal 2 - Frontend:

    npm run dev
  5. Access the app

Test Accounts

Quick Deploy

  1. Create D1 database: wrangler d1 create vaultcloud-db
  2. Create KV namespace: wrangler kv:namespace create SESSIONS
  3. Update wrangler.toml with IDs
  4. Deploy Worker: npm run worker:deploy
  5. Build frontend: npm run build
  6. Deploy to Cloudflare Pages via dashboard or GitHub Actions

Roadmap — Desktop & Mobile App Development

Goal: Expand VaultCloud into native Desktop and Mobile apps while ensuring full support for major browsers and specified operating systems.

  1. Overview
  • Support in parallel: Web (PWA), Desktop (Windows, macOS, Linux), Mobile (iOS, Android).
  • Priorities: security, secure synchronization, feature parity across platforms, offline experience.
  1. Platform & browser support
  • Desktop
    • Windows: Windows 10+ (MSI/EXE installer, auto-update)
    • macOS: macOS 10.15+/11+ (dmg / signed .pkg, notarization)
    • Linux: Ubuntu/Debian/Fedora/* (AppImage, .deb, .rpm, Snap/Flatpak)
    • Web/PWA browsers: Chrome, Edge (Chromium), Firefox, Safari — support the latest 2 major versions.
  • Mobile
    • Android: Android 8+ (APK / Play Store)
    • iOS: iOS 14+ (App Store, TestFlight)
    • Mobile browsers: Chrome for Android, Safari on iOS, Samsung Browser, Firefox Mobile

License

MIT License

About

No description, website, or topics provided.

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages