SamGu-NRX / BaseScanning

# BaseScanning: House Scanning App for Base Core
Walk along the wall by your electric meter with an iPhone, and find out whether a home battery fits there and where it would go.
Live site · How it works · Demo API
When a potential customer wants to determine whether a Base Power battery can be placed on their property, they have to send photos of their power meter and the wall it's on. Then, someone at Base has to decide where the battery goes using the photos the homeowner sends in.
That's a pretty rough way to do it. Measuring distances within a photo is challenging, and a photo is unable to illustrate what sits outside its frame. This could mean that another check would be needed -- a hassle for both Base and the interested homeowner.
We want to change that: the assessment should be just one walk. The homeowner opens our app and scans the outside wall around their meter. The app keeps guiding them, and asks for another angle whenever it needs one, until it has seen everything the placement rules care about. Then it sends what it captured to our server. The server builds a 3D model of the wall, checks every rule against it and sends back an answer. If the battery fits, the app shows it standing on the real wall through the phone's camera. Augmented Reality (AR) lets the homeowner see the spot before anyone installs anything.
Four of us built this for Base Power at a hackathon that started on September 25, 2026. Who built this says who worked on what.
## Try it out
The quickest way to see it work is the demo server, which is already running. Ask it how it's doing:
 [code] 
It replies with `"status":"ok"` and a note about which rules it's using. The demo server knows only the public rules, never Base's own.
To work on the code, you'll need uv, Node 24 with pnpm, and Xcode 26 or newer. Clone the repository with its submodules and run the tests:
 [code] 
`make check` runs the same server, web and iOS test suites that CI runs. Xcode runs only on a Mac, so on Linux or Windows, run `make server web` to skip the iOS suite.
## How the pieces fit together
Here's the whole trip, from the homeowner's phone to our server and back again. Each band is one part of the system, and each box names the framework and the call that does the work. The yellow shapes are the files that pass between parts. Dashed lines are optional, so the app works without LiDAR, and the reconstruction worker runs only when someone sends it the photos.
Here's what we didn't compromise on: while the ML models handle the fuzzy parts -- turning photos into a 3D wall, recognizing a gas meter -- they *never* make the call as to whether a battery fits. That decision comes from a deterministic, criteria-matching evaluation that holds each measurement against the bounds of its rule. If a measurement is within bounds, great: that check is a PASS. If it's out of bounds, the check is a FAIL. If the margin of error makes it too close to call, the check comes back UNSURE.
The criteria (e.g. the dis