Travel Expense App
English · 繁體中文（廣東話）
Track travel expenses, organize receipts and itineraries, and calculate shared costs. Each trip has its own records. Compact is the main public app; the parallel React client uses compatible data contracts.
Open the app
The GitHub Pages root redirects to Compact. Check the version shown in Settings when reporting an issue. Source versions and deployed versions can differ; this README is not a deployment receipt.
First-time setup
- Open Compact and sign in with your own email or 使用 Google 帳號登入 (Sign in with Google). If using an email sign-in link, open the link from your inbox.
- Follow the welcome guide to create a trip: enter its name, destination and dates.
- Set your budget and trip currency. Add travel companions and their sharing weights if needed. The initial companion is
User 1.
- Add an expense, review the extracted or entered details, then save it.
- Open 紀錄 (Records) to confirm it appears under the correct trip.
Use a separate account for each person. Expense-splitting companions are calculation participants; adding one does not grant another app user access to the trip.
Everyday use
| Screen / Chinese label | What to do |
|---|
| Home / 首頁 | Select the active trip; check your budget, today's spending and itinerary. |
| Scan / 記帳 | Take a receipt photo, choose an image, paste email text, enter an expense manually or use voice input. |
| Records / 紀錄 | Search and filter expenses; open a record to review or edit it. |
| Itinerary / 行程 | View the trip's daily places, times and related expenses. |
| Weather / 天氣 | Choose a day and location; inspect hourly forecasts, source and freshness. |
| Stats / 統計 | Review totals, spending categories and shared costs. |
| Settings / 設定 | Manage trips, exchange rates, AI models, sync, themes and backups. |
Always select the correct trip before adding or syncing records. Before saving a receipt, check its merchant, date, time, currency, amount, payment method, payer and sharing mode. AI output is a draft and may need correction.
Exchange rates and calculator
Rates are displayed as 1 HKD = N units of the trip currency.
- In 設定 → 匯率設定 (Settings → Exchange rates), choose live or fixed mode, then confirm. Typing a fixed rate alone does not apply it. Failed live-rate confirmation preserves the previous setting.
- Scan's top-right 匯率 button also lets you switch modes or enter and apply a fixed rate. Rate-source information is shown in Settings.
- 貨幣計數機 (Currency calculator), below the Scan input buttons, converts amounts in either direction using live or fixed rates. Calculator-only rate edits do not change the trip's confirmed settings.
- The receipt editor shows the current rate. Choose 鎖定匯率 (Lock rate) to enter a rate for that receipt or use an available preset. Date/time, category/payment and payer/sharing fields sit side by side on phones.
- Saved receipts retain their recorded rates and HKD amounts when the app's exchange-rate setting changes.
Itinerary and weather
Paste itinerary, hotel, restaurant, transport or booking text into Trip Update AI. Review the proposed dates, places and missing details before applying changes.
Weather uses the selected trip date and location. Its hourly rail opens at the corresponding local clock hour where available, and you can select another hour. Forecasts distinguish observations, daily bulletins and hourly models, including their sources and freshness. Official services are preferred where supported; missing fields can use labelled fallback providers. Unavailable dates or fields are shown explicitly. Device location requires your action and browser permission.
AI models
In 設定 → AI 模型選擇, expand a task category, then a provider, to choose a model. The category header shows the current model without expanding it.
- Automatic photo routing: Muse Spark Contributor, then MiMo-V2.6-Flash.
- Automatic text routing: free Nemotron 3 Super, North Mini Code, Apodex Mini, then paid Qwen3.7 Flash.
- An explicit selection makes one model attempt and shows failures. HTTP
429, quota and daily-limit errors stop automatic retries to other models.
- Availability tests use the exact selected model, no fallback, and an eight-output-token budget; Muse Contributor requires 16 tokens. Normal task budgets are separate.
All credentialed AI calls go through the server-side Credential Broker. Never paste a provider API key into public frontend code or a backup. Manual expense entry remains available when AI is unavailable.
Themes
Use 外觀主題 (Appearance) in Settings. 自動（依旅程） follows the active trip's recommendation; a manual choice stays selected across trips. The current catalog includes regional and style themes, with light and dark options. Selection saves immediately. Compact's theme UI is independent of the parallel React client.
Sync and trip sharing
Supabase is the shared primary store. Notion is an optional mirror.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
