# Installing Daygig

## Packaged App

If you received `Daygig.app` on macOS or `Daygig.exe` on Windows, you do not need to install Python. Double-click the app to start Daygig. Use the shut down button inside Daygig when you are done.

On first launch, macOS may ask whether Daygig can find devices on local networks. Daygig runs a private local server on your own computer so the browser interface can talk to the app. Click **Allow**.

---

Daygig now supports two install paths.

## Easiest: Packaged Build

Use this if you received a standalone Daygig build.

### macOS

1. Open the Daygig folder.
2. Double-click `Daygig.app`.
3. Your browser opens automatically.

If macOS says the developer cannot be verified:

1. Right-click `Daygig.app`.
2. Choose **Open**.
3. Choose **Open** again.

### Windows

1. Open the Daygig folder.
2. Double-click `Daygig.exe`.
3. Your browser opens automatically.

If Windows SmartScreen appears, choose **More info** → **Run anyway** for beta builds.

## Source/Test Folder Fallback

Use this if you received the raw source folder instead of a packaged build.

### macOS source folder

1. Install Python 3.10 or newer from python.org/downloads.
2. Double-click `Daygig.command`.

If macOS says you do not have permission to run it, open Terminal and run:

```bash
chmod +x ~/Desktop/daygig/Daygig.command
```

Adjust the path if your Daygig folder is somewhere else.

### Windows source folder

1. Install Python 3.10 or newer from python.org/downloads.
2. During install, check **Add Python to PATH**.
3. Double-click `Daygig.bat`.

## First Setup

When Daygig opens, choose:

- **Personal Finance** if you are testing Daygig as a spending tracker.
- **Business / Creative Side Hustle** if you sell products, manage inventory, or need business reports.

Personal testers can use:

`sample_data/personal_bank_sample.csv`

## Stopping Daygig

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

## User Data Location

Packaged builds store your data here:

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

Source/test folders store data in the Daygig folder itself.

## Troubleshooting

**Browser opens but says the site cannot be reached**  
Wait a few seconds and refresh. The local server may still be starting.

**Windows says `python3` is not recognized**  
Use the packaged `Daygig.exe`, or reinstall Python and make sure **Add Python to PATH** is checked.

**Another app is using port 4848**  
Restart your computer and try again.

**The app shows a blank screen or internal server error**  
Restart Daygig and send Brian any error text shown in the window or logs.

---

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