# Bills — Getting Started

## How to Run

1. **Extract** this ZIP file to any folder (e.g., your Desktop or Documents)
2. **Open** the extracted `BILLS` folder
3. **Double-click** `Bills.command`
4. Your browser will open automatically with the app

That's it!

## First Launch

On the first launch, macOS may show a security warning:
> "Bills.command" is from an unidentified developer.

**To allow it:**
- Go to **System Settings → Privacy & Security**
- Scroll down and click **"Open Anyway"**
- This only needs to be done once

## Stopping the App

- Close the Terminal window that opened, **or**
- Press `Ctrl+C` in the Terminal window

## Troubleshooting

| Problem | Solution |
|---------|----------|
| Browser doesn't open | Go to http://127.0.0.1:5000 manually |
| App crashes silently | Create a file named `debug_mode.flag` in the BILLS folder, then relaunch |
| "Operation not permitted" | Right-click `Bills.command` → Open (instead of double-click) |
| Port 5000 in use | The app will automatically find the next available port |

## Need Help?

Contact your system administrator or the development team.
