Skip to content

TinyActive/VaultCloud

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

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published