Skip to content

Latest commit

ย 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

SubVault ๐Ÿ›ก๏ธ

SubVault is a privacy-focused, local-first subscription manager designed to help you track your digital subscriptions and fixed expenses directly in your browser.

Note: Your data is stored locally on your device. No servers, no tracking.

โœจ Features

  • ๐Ÿ”’ 100% Privacy: Your data never leaves your device.
  • โšก Local-First: Built with IndexedDB (via Dexie.js) for offline-first capability.
  • ๐Ÿ“Š Dashboard: View monthly expenses and active subscriptions at a glance.
  • ๐Ÿ“ Subscription Management: Add and manage subscriptions with predefined platforms.
  • ๐Ÿ’ฑ Multi-Currency: Automatic currency conversion with customizable exchange rates.
  • ๐ŸŒ i18n Support: Available in English and Turkish.
  • ๐Ÿ”„ Active/Inactive Toggle: Easily pause subscriptions without deleting them.
  • ๐Ÿ’พ Data Control: Export your data to JSON for backup and import it whenever needed.
  • ๐ŸŽจ Modern UI: Clean, responsive interface built with shadcn/ui components.

๐Ÿ› ๏ธ Tech Stack

  • Framework: React 19 + Vite
  • Language: TypeScript
  • Styling: Tailwind CSS v4 + shadcn/ui
  • Database: Dexie.js (IndexedDB wrapper)
  • State Management: Zustand
  • i18n: react-i18next
  • Icons: Lucide React
  • Package Manager: pnpm

๐Ÿš€ Getting Started

Prerequisites

  • Node.js (v18 or higher recommended)
  • pnpm

Installation

  1. Clone the repository:

    git clone https://github.com/berkayburakm/sub-vault.git
    cd sub-vault
  2. Install dependencies:

    pnpm install
  3. Start the development server:

    pnpm run dev
  4. Open your browser and navigate to http://localhost:5173.

๐Ÿ“– Usage

  1. Add a Subscription: Click "Add Subscription" and select from predefined platforms (Netflix, Spotify, etc.).
  2. Currency Conversion: Set your preferred currency and exchange rates in Settings โ†’ Currency.
  3. Toggle Active/Inactive: Hover over a subscription and click the power icon to pause it.
  4. Manage Data: Use Settings โ†’ Data to export/import your subscriptions.

๐Ÿ”ฎ Future Roadmap

  • Notifications: Browser notifications for upcoming payments.
  • PWA Support: Install as a native-like app on mobile and desktop.
  • Charts: Visual breakdown by category.
  • Recurring Payment Calculator: Annual cost projections.

๐Ÿ“„ License

This project is open source and available under the MIT License.

About

๐Ÿ›ก๏ธ๐Ÿ’ฐ SubVault is a privacy-focused, local-first subscription manager designed to help you track your digital subscriptions and fixed expenses directly in your browser.

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages