DEV Community

Hearthplug
Hearthplug

Posted on

Mosaic ERP v1.3.4: fixing the first run of an ERP that sets itself up from an interview

Mosaic ERP is an open-source (MIT) retail ERP. The idea is simple: instead of a setup screen with hundreds of switches, the owner answers plain-language questions about how the shop works, and Mosaic configures the working system from those answers: stock, sales, buying, money and books.

Mosaic owner interview

v1.3.4 shipped today. It's a first-run release: everything in it is about what happens in the first ten minutes after someone installs Mosaic.

The bug that mattered most: Apply didn't always apply what you reviewed

After the interview, Mosaic shows the owner a review of the setup it's about to install. In earlier versions, pressing Apply could install a different profile from the one on screen. For a coaching or services business, that meant stock tracking and supplier credit could get switched on even though the owner said they didn't need them.

In v1.3.4, Apply installs exactly the profile you reviewed.

Reviewing the setup before Apply

The first sale should just work

An ERP that's "configured" but can't post its first invoice isn't configured. Apply now creates the accounting defaults up front: accounts, document sequences, and your country's currency. Older workspaces that were missing them fix themselves the first time they're used.

Smaller fixes in the same release:

  • Settings is reachable from the workspace menu.
  • Malformed API requests get a clear 400 instead of a 500.
  • The Assistant (still a Preview) answers everyday questions like "Show me the tax settings" with the real answer or a link to the right screen.

A real Windows installer

Until now Windows users got a portable exe. v1.3.4 adds MosaicERP-windows-x64-setup.exe, which:

  • shows up in Settings > Apps as "Mosaic ERP" (publisher Hearthplug), with Start Menu and desktop shortcuts
  • has an uninstaller that stops the running services and then asks whether to keep or delete your shop data

The portable exe is still there, and the Mac build (Apple Silicon dmg) ships from the same commit.

A note on signing: the installers are unsigned for now, so Windows SmartScreen will say "Windows protected your PC" (click More info, then Run anyway) and macOS wants a right-click > Open the first time.

Mosaic workspace

Try it

If you've ever set up an ERP for a small business, we'd like to know which questions you'd expect the interview to ask that it doesn't yet. Issues and PRs are welcome.

Top comments (0)