# Daygig

**Local personal finance + creative-business bookkeeping.**

Daygig runs on your computer, stores data locally, and does not require a subscription or cloud account. It can be used two ways:

- **Personal Finance** — import bank CSVs, review spending, categorize transactions, spot recurring charges, and see where your money went.
- **Business / Creative Side Hustle** — track sales, receipts, products, materials, inventory, orders, projects, reports, and tax/compliance tools.

## Starting the App

### Packaged build

**macOS:** double-click `Daygig.app`  
**Windows:** double-click `Daygig.exe`

Daygig starts silently, opens your browser, and runs in the background. No Terminal or Command Prompt is needed.

### Source/test folder fallback

If you are running the unpackaged development folder:

**macOS:** double-click `Daygig.command`  
**Windows:** double-click `Daygig.bat`

Those launchers prefer the packaged app/exe when present, then fall back to `python3 app.py` for beta/source folders.

## Stopping the App

Click the **Shut Down** button in Daygig, then close the browser tab.

In packaged builds, that shuts down the hidden local server. In source/test folders, it also stops the Python process.

## Where Your Data Lives

Packaged builds store user data outside the app so updates do not overwrite your books:

- **macOS:** `~/Library/Application Support/Daygig/`
- **Windows:** `%APPDATA%\Daygig\`

That folder contains:

- `daygig.db`
- `backups/`
- `receipts/`
- `product_images/`

Source/test folders still keep `daygig.db` next to the source files for development compatibility.

## First Run

The setup wizard opens automatically.

Choose one of these modes:

- **Personal Finance** — best for testers who want a simple money tracker.
- **Business / Creative Side Hustle** — best for makers, sellers, freelancers, merch, inventory, and taxes.

Personal mode uses plain-language screens like **Money In**, **Money Out**, **Left Over**, **Review**, **Spending Categories**, and **Spending Reports**.

Business mode enables the fuller bookkeeping/inventory system.

## Personal Finance Testing

A sample CSV is included:

`sample_data/personal_bank_sample.csv`

Use it to test the import flow without using real bank data:

1. Choose **Personal Finance** in setup.
2. Go to **Transactions** → **Import**.
3. Upload the sample CSV.
4. Map columns:
   - Date → `Date`
   - Description → `Description`
   - Amount → `Amount`
5. Import the rows.
6. Go to **Review** and categorize transactions.
7. Return to the dashboard and check the spending summary.

## Building a Standalone App

Install PyInstaller, then run one of the build helpers from the project folder:

- **macOS:** `./build-mac.command`
- **Windows:** `build-windows.bat`

The build output appears in `dist/`.

## Selling / Support Notes

Before selling Daygig publicly, ship the packaged app with the included buyer
documents:

- `PRIVACY.md` — what stays local, and which optional features make network calls.
- `TERMS.md` — license, permitted use, limits, and tax/accounting disclaimer.
- `REFUND_POLICY.md` — plain-language refund window and support path.
- `SUPPORT.md` — where buyers get help and what details to send.

## Requirements for Source/Test Folders

- Python 3.10 or newer
- A modern browser
- No npm, no framework, no subscription

Packaged builds include Python and do not require a separate Python install.

---

*Daygig v0.1.1 — A product of CnF Works*
