2a1286e98a
## 🚪 Why? ### Problem Dead frontend components were accumulating in the codebase with no automated way to detect them. Unused code increases maintenance burden, confuses contributors, and inflates bundle analysis noise. Additionally, several React hooks had incorrect dependency arrays causing stale closures or unnecessary re-renders, and an unused variable was left in the new test file. ## 🔑 What? ### Changes - Add `resources/js/lib/orphan-components.test.ts` — a Vitest test that scans every file under `resources/js/components/` and fails if any component is never imported anywhere in the codebase (supports `@/` alias imports, relative imports, and barrel `index.*` re-exports) - Delete 14 orphan components identified by the new test: - `accounts/import-balances/import-balance-step-{account,mapping,preview,upload}` - `app-mobile-nav` - `appearance-dropdown` - `dashboard/stat-card` - `landing/encryption-video-player` - `sync-status-button` - `transactions/date-header` - `ui/{icon,input-group,navigation-menu,placeholder-pattern}` - Restore `ui/avatar.tsx` which was incorrectly included in the deletion (it is imported via relative path in `user-info.tsx`) - Fix ESLint warnings across 5 files: - `orphan-components.test.ts` — remove unused `componentDir` variable in `importStrings()` - `transaction-list.tsx` — remove `categories`, `accounts`, `banks`, `automationRules` from `useCallback` deps (none referenced in callback body) - `amount-input.tsx` — add missing `locale` dep to `useEffect` (used in `formatCurrency`) - `use-dashboard-data.ts` — wrap `fetchData` in `useCallback([locale])` and add to `useEffect` deps to prevent stale closure on locale - `dashboard.tsx` — wrap `netWorthEvolution` fallback in `useMemo([props.netWorthEvolution])` to stabilise the reference passed to the downstream `useMemo` ## ✅ Verification ### Tests The new test runs as part of `bun run test` (Vitest), already executed in the `linter` CI job. All 48 tests pass: ``` ✓ resources/js/lib/chart-calculations.test.ts (32 tests) ✓ resources/js/lib/file-parser.test.ts (15 tests) ✓ resources/js/lib/orphan-components.test.ts (1 test) ``` `bun run lint` and `bun run build` now exit clean. Going forward, any new component added to `resources/js/components/` that is not imported anywhere will fail CI automatically. |
||
|---|---|---|
| .agents/skills | ||
| .claude/skills | ||
| .cursor | ||
| .github | ||
| .opencode/skills | ||
| app | ||
| bootstrap | ||
| config | ||
| database | ||
| docker | ||
| lang | ||
| public | ||
| resources | ||
| routes | ||
| screenshots | ||
| scripts | ||
| src/lib/crypto | ||
| storage | ||
| templates/coolify | ||
| tests | ||
| .editorconfig | ||
| .env.example | ||
| .env.production.example | ||
| .gitattributes | ||
| .gitignore | ||
| .mcp.json | ||
| .php-cs-fixer.dist.php | ||
| .php-version | ||
| .prettierignore | ||
| .prettierrc | ||
| .release-it.json | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| Caddyfile | ||
| Dockerfile | ||
| Dockerfile.production | ||
| LICENSE.md | ||
| LOCALIZATION.md | ||
| README.md | ||
| artisan | ||
| boost.json | ||
| bun.lock | ||
| components.json | ||
| compose.yaml | ||
| composer.json | ||
| composer.lock | ||
| docker-compose.production.yml | ||
| eslint.config.js | ||
| opencode.json | ||
| package-lock.json | ||
| package.json | ||
| phpunit.xml | ||
| tsconfig.json | ||
| vite.config.ts | ||
| vitest.config.ts | ||
| vitest.setup.ts | ||
| whispermoney | ||
README.md
Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文
Whisper Money
The most secure way to understand your finances.
Whisper Money is a privacy-first personal finance application that helps you track, categorize, and understand your spending—all while keeping your financial data encrypted and secure.
🎮 Try the Demo: Experience Whisper Money with our demo account - no registration required!
💬 Join our Community: Whether you're a user looking for help or a developer wanting to contribute, we'd love to have you in our Discord server! Share feedback, ask questions, discuss new features, or just hang out with fellow privacy enthusiasts.
Features
- 🔐 Privacy-first — Your data is never shared with third parties. You own it
- 🏦 Bank account management — Track multiple accounts in one place
- 📊 Transaction categorization — Automatic and manual categorization
- 🤖 Automation rules — Set up rules to auto-categorize transactions
- 📈 Financial insights — Understand your spending patterns
Tech Stack
- Backend: Laravel 12, PHP 8.4
- Frontend: React 19, Inertia.js v2, TypeScript
- Styling: Tailwind CSS v4
- Database: MySQL
- Cache/Queue: Redis
- Testing: Pest v4
Running Locally
Quick Start (Recommended)
The easiest way to get started is using our automated setup script:
bash <(curl -fsSL https://whisper.money/setup.sh)
After installation, just visit https://whisper.money.local in your browser.
Manual Setup
If you prefer to set up manually:
- Clone the repository:
git clone https://github.com/whisper-money/whisper-money.git
cd whisper-money
- Run the setup script:
whispermoney install
Available Commands
Important: You must run
whispermoney installbefore using any other command. If you skip the install step, commands likestartwill not work.
Once installed, you can use the whispermoney command for common tasks:
# Start all services
whispermoney start
# Stop all services
whispermoney stop
# Upgrade to latest version
whispermoney upgrade
# Interactive menu
whispermoney
Development Server
For active development with hot reloading:
composer run dev
This will concurrently start:
- PHP development server
- Queue worker
- Log viewer (Pail)
- Vite dev server
The application will be available at https://whisper.money.local or http://localhost:8000 (direct PHP server).
Running with Docker (Production Image)
For testing the production Docker image locally:
- Copy the production environment file:
cp .env.production.example .env
- Start the services:
docker compose -f docker-compose.production.yml up -d
The application will be available at http://localhost:8080.
To use a different port, set APP_PORT:
APP_PORT=3000 docker compose -f docker-compose.production.yml up -d
Deploying to Coolify
Whisper Money can be easily deployed to Coolify using our Docker Compose template.
Quick Deploy
- In Coolify, create a new resource and select Docker Compose
- Choose Empty Compose File as the source
- Paste the contents from our template: 👉 whisper-money.yaml
- Deploy!
The template includes:
- Whisper Money application container
- MySQL 8.0 database with health checks
- Persistent volumes for data and storage
- Auto-generated database credentials
Required Environment Variables
| Variable | Description |
|---|---|
RESEND_API_KEY |
Email service API key (for password resets, notifications) |
Note:
APP_KEYandAPP_URLare auto-configured. The container generates anAPP_KEYon first startup if not provided.
Optional Environment Variables
| Variable | Default | Description |
|---|---|---|
DRIP_EMAILS_ENABLED |
true |
Enable drip emails (welcome, onboarding, feedback) |
HIDE_AUTH_BUTTONS |
false |
Hide login/register buttons on landing page |
SUBSCRIPTIONS_ENABLED |
false |
Enable Stripe subscriptions |
STRIPE_KEY |
- | Stripe publishable key |
STRIPE_SECRET |
- | Stripe secret key |
STRIPE_WEBHOOK_SECRET |
- | Stripe webhook signing secret |
Star History
License
This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.