Projects, Versions, And Scenarios Explained

If the app feels confusing at first, this is usually the reason. GridGap stores one job, the saved options inside that job, and the actual modeled setup for each option as three separate layers.

Projects

A project is the overall job. It might be one house, one RV, one boat, one office, or one workshop.

If you're comparing different ways to solve that same job, keep them inside one project. Don't split them into separate projects unless they are genuinely separate jobs.

Versions

A version is a saved option inside the project. It is the main comparison layer in GridGap.

One version might hold an AC backup option. Another could hold a DC distribution option. A third might use a mixed AC/DC solar path, or keep the same scenario type but change battery size, inverter size, or recharge assumptions.

Older versions stay editable. If you reopen Version 1 later and calculate it again, you are updating that version only.

Give versions clear names once there is more than one. "48V lithium option" is far more useful than relying on a version number and hoping you'll remember what it was.

Scenarios

A scenario is the actual modeled setup inside the version. This is where the loads, battery settings, inverter settings, charging, and solar inputs come together.

In normal use, a version carries one working scenario. New users can reach it through guided setup. That flow chooses the scenario type, builds the load groups, collects worst-case usage hours, and then uses Continue to Scenario Settings. GridGap shows that the scenario is ready before opening a seeded starting point. If you already know what you want, choose Start with blank scenario settings and pick the scenario type in the blank scenario modal.

The important distinction is that versions are the long-term comparison layer. Scenarios are the modeled setups that live inside a version.

How to move between them

Start on the Projects page. Open a project with the eye icon, then choose the version you want to work on.

From there you usually move into one of two places. The scenario editor is where you enter or change inputs. The results page is where you inspect the saved calculation for that version.

Calculate behavior

Calculate recalculates the version you are currently editing and replaces only that version's stored results.

Create New Version preserves the current version and opens a new version for further work. It does not calculate the new version automatically.

Use Calculate when you are still working on the same saved option. Use Create New Version when the current option is worth keeping and you want to branch into a comparison.