# ShopDB dev build - quick test

Two dev builds you can stand up on a Windows box with Docker Desktop. You run
one PowerShell script: it clones the repo, checks your dependencies (offers to
winget-install anything missing), then builds and starts the stack in Docker.

## What you need

- Windows with Docker Desktop running.
- Git for Windows (`winget install Git.Git`).
- A GitHub login for this private repo already stored on the box. If you have
  cloned this repo before, or signed in to GitHub in Visual Studio or VS Code,
  you already have it - the script uses that stored credential automatically, so
  there is no token to paste. If you have never signed in, do one manual
  `git clone https://github.com/ge-aero/shopdb-flask.git` first (it will prompt
  you to sign in), then delete that clone - it is only to seed the credential.

## Get the launcher

You will be sent `Start-ShopDBDev.ps1` directly. Save it anywhere (for example
your Downloads folder) and open PowerShell in that folder.

## Bleeding edge (dev-be)

	powershell -ExecutionPolicy Bypass -File .\Start-ShopDBDev.ps1 -Channel edge

Comes up at https://localhost:5011. Red DEV badge in the sidebar.

## Stable (main)

	powershell -ExecutionPolicy Bypass -File .\Start-ShopDBDev.ps1 -Channel stable

Comes up at https://localhost:5001. No DEV badge.

## Notes

- Both builds can run at the same time - they use different ports and separate
  Docker volumes, so they do not collide and each keeps its own database.
- The code is cloned to `%USERPROFILE%\shopdb-dev` (override with `-TargetDir`).
- First page load shows a self-signed cert warning (expected for a dev box).
- Stop a stack:  `docker compose -p shopdb-stable down`  (or `shopdb-edge`).