mise.

Troubleshooting

Common issues and fixes. If your problem isn't here, contact us with a description of what you did and what you saw.

Installation and launch

Windows SmartScreen blocks the .exe

What you see: "Windows protected your PC" blue screen when you double-click the .exe.

Fix: Click More info → Run anyway. Windows remembers the choice for that machine. This happens because the .exe isn't signed by a Microsoft-recognized certificate authority — it's expected.

If SmartScreen is configured strictly enough that the "Run anyway" button doesn't appear: right-click the .exe → Properties → check Unblock at the bottom of the General tab → OK.

App opens then immediately closes

Usually means it can't create its database file. Reasons:

  1. The folder is read-only. Move the .exe out of C:\Program Files\ or other admin-required locations. Try Desktop or C:\Apps\MiseManager\.
  2. Antivirus is quarantining it. Check your AV's quarantine list and whitelist Mise Manager.
  3. Disk full or AppData unavailable. Check %APPDATA%\Mise Manager\ exists and you have write permission.

"The procedure entry point could not be located" or similar DLL error

The .exe was corrupted during download or transfer. Re-download from the source.

App launches but the window is blank / black

Usually a graphics driver issue with Electron's GPU acceleration. Workaround: create a shortcut to the .exe and add --disable-gpu to the target. Or update your graphics drivers.

Data and costs

Costs not computing

What you see: a menu item or recipe shows Live cost: 0.00 / g (or some other unit) even though the recipe has lines.

Most common cause: yield unit doesn't match the item's base unit. Example: menu item's base unit is g, but the recipe yield is 1 portion. Those are different dimensions, the engine can't divide.

Fix: pick one approach:

  • Items page → edit the item → change Base unit to piece / portion (most natural for menu items)
  • OR Recipes page → edit the recipe → change yield to the actual weight in g (e.g. "250 g per portion")

The Recipes editor now shows a red banner immediately when there's a unit mismatch.

Actual food cost % shows "—" on a MENU item

Two possible causes:

  1. No selling price set. Items page → edit the item → fill in Selling price. Save.
  2. The cost is 0 (unit mismatch — see above). Fix the unit mismatch and the food cost % will compute.

Sales picker shows "no MENU items yet" even though I have one

  1. Click Refresh (top right of the Sales tab)
  2. If still empty, switch to another sidebar tab and back
  3. If still empty, fully quit and reopen the app
  4. Verify on the Items page that the item's Type is set to MENU (not RAW / PROCESSED / SUBRECIPE)
  5. Verify you're on the right shop (top-left dropdown)

A new item I created doesn't appear in the dropdown of an open page

Other tabs cache their item list when first loaded. Switch away and back to refresh, or click the Refresh button if the tab has one.

Inventory went negative

That's intentional — the app lets stock go below zero so you can see when you've sold more than you should have on paper. Negative inventory is a flag that:

  • You sold something you didn't track receiving
  • A recipe is wrong (consuming more of an ingredient than you actually use)
  • You opened with a positive count you never logged

Fix by Receiving what's actually there (correctly logged), or doing a Count which captures the variance.

"Total cost" shows a number but "Cost per gram" shows "—"

Same root cause as "Costs not computing" above — unit mismatch between the recipe yield and the item base unit. The line totals can still sum (they're in each line's own base unit), but the division fails.

Deletes and errors

"Can't delete this — something else still depends on it"

This is a foreign key constraint. You're trying to delete something (item / supplier / shop) that's referenced elsewhere. Fix the references first:

  • Trying to delete an item used in a recipe → first remove that recipe line (or delete the recipe entirely if the dish is gone)
  • Trying to delete a supplier used in supplier_items → unattach the supplier from each item that references it
  • Trying to delete an item used in past sales → you can't, history is sticky. If you really must, delete those past sale entries first (lose the audit trail), then delete the item.

This is by design — silent cascading delete would risk losing data you want.

After deleting something, the form for adding new ones doesn't work

If you're on the same dev build that had this bug: restart the app. The fix has been deployed in 0.2.0+. Errors during delete now surface as toast notifications, and forms remain functional.

Undo button on a deleted sale doesn't appear

Only some deletes have Undo (Sales and Production currently). For others (items, recipes, suppliers, shops), the confirmation modal is the safety mechanism.

If Undo should be there and isn't: the toast timed out (10 seconds). The delete is final.

Multi-shop

Wrong data shown on a tab

Check the shop dropdown at the top of the sidebar — you might be viewing a different shop than you think. Every per-shop tab reflects the currently-selected shop.

Items I add in one shop don't appear in another

Items are shared catalog — they should appear in every shop. If they don't:

  • Refresh the tab (some tabs cache lists)
  • Verify by switching to the other shop and back

If they really don't show up, that's a bug — contact us.

Cost shows ₱0.00 on a shop that has the same items as another shop

That's normal — pricing is per-shop. The other shop has supplier prices attached; this one doesn't. Items page → attach a supplier for each item in this shop.

I deleted my "Main" shop and now nothing works

You shouldn't be able to delete the last remaining shop — the trash button is disabled. If you somehow ended up with no shops, Sidebar → Shops → New shop to create one.

Performance

Dashboard is slow

The Dashboard does a lot of queries (operations report, projection, cost intelligence, ingredient usage, trends — five sections of aggregations). With thousands of moves and sales entries, expect 2–5 seconds. If you find it routinely sluggish on smaller datasets, contact us.

Sales picker takes a while to filter

If you have hundreds of MENU items, the dropdown is just rendering a lot. Type to filter; the browser handles search-as-you-type natively.

Recipe save is slow

After save, the cost engine runs a full topological recompute across every item in every shop. If you have many shops × many items, this takes a moment. It's a one-time hit per save, not on read.

Backup / restore

"Import DB" succeeded but my data is still the old data

The app forces a window reload after import, but rarely the reload fails. Fully quit the app and reopen.

Backups I saved don't open in another machine's Mise Manager

If the backup was taken on a newer version of the app and you're trying to import on an older version, the schema is incompatible. Get the newer .exe first, install it on the destination machine, then import.

Export DB doesn't write any file

Check that you didn't cancel the save dialog. If you completed it, check disk space on the target drive.

Photos and videos

Photo I attached doesn't show

Photos are stored in %APPDATA%\Mise Manager\media\. If you deleted that folder or the specific file inside it, the path stored in the DB now points to nothing.

To re-attach: edit the item → Remove the photo → Add a new one.

Video plays without sound

Electron's bundled video codec stack is limited — H.264 with AAC works reliably, others may not. Convert to .mp4 (H.264 + AAC) before attaching.

Printing

Print preview opens but nothing prints

The Print button calls Windows' native print dialog. If no printer responds:

  • Make sure a printer is installed and online
  • Try printing a test page from Windows Settings
  • The modal also lets you "save as PDF" via the Windows print dialog if you have a PDF printer configured

Print is missing subrecipes

The Print modal only shows recipes that exist. If a SUBRECIPE line in your menu's recipe doesn't have its own recipe defined, it appears as a leaf without expansion. Define the subrecipe's own recipe to see it expanded.

When to contact us

We want to know about:

  • Crashes (app closes unexpectedly, you have a screenshot of an error)
  • Data going missing without you deleting it
  • Costs computing visibly wrong (you can show math)
  • Migrations failing on app start
  • Any consistent issue across multiple restarts

Include:

  • Version (sidebar footer or package.json if you have the source)
  • What you did just before the issue
  • Screenshot if visible
  • Whether a restart fixed it
← Backup, Data & Cloud Sync