Wheat

Wheat is a Windows-first, local accounting desktop application for Moroccan small businesses, fiduciaires and accounting offices. It uses Electron, React, TypeScript, Prisma and SQLite. The packaged app keeps its accounting, OCR, reporting, reconciliation, tax-workpaper, import, backup and assistant workflows on the computer; none of them requires a cloud account or a subscription.

Wheat is not certified by the DGI or another authority, and it does not replace review by a qualified Moroccan accounting or tax professional. See Known limitations.

Wheat 2.0 highlights

Wheat 2.0 is an interface release: the accounting engine, tax rules, reconciliation, imports, exports, OCR behaviour and database meaning are unchanged, and no feature was removed.

• A rebuilt interface. A grouped navigation rail replaces the flat sidebar; every screen opens with a one-sentence statement of what it is for, a map of what lives on it, and a collapsed "how this works" explanation. Tables, cards, dialogs, filters, empty, loading and error states all come from one design system.
• Understandable without accounting training. Correct terminology is kept — écriture, lettrage, extourne, liasse — and explained in place, so a business owner or a new employee can follow a screen without a glossary.
• Every feature stays visible. All eighteen destinations keep their own labelled navigation entry, each with a plain-language description. Nothing moved into an unlabelled overflow menu; right-click menus only duplicate buttons that are already on screen.
• One searchable dropdown everywhere. Accounts, companies, journals, documents, counterparties, invoices, periods and models all use the same combobox with an integrated search bar, keyboard navigation, a visible focus ring, and explicit loading, error and no-result states.
• A centralised Wheat design system. Colour, typography, spacing, radii, borders, shadows, surfaces and every component state resolve through tokens in src/styles/tokens.css. Light and dark mode are both first-class, built from the official Wheat palette.
• Wheat AI providers. Alongside local models, Wheat AI can now use the free tiers of OpenRouter and Groq. Keys are encrypted by the operating system's own credential vault, never stored in plaintext and never returned to the interface. Automatic — free models ranks verified free models and fails over when one is rate-limited, exhausted or withdrawn.

The exact 2.0 implementation, evidence and known limits are recorded in the Wheat 2.0 implementation report.

Wheat 2.0 bank-import foundation retained

• Relevé bancaire imports support CSV, delimited TXT, XLSX, OFX, QIF, MT940, CAMT.053 XML, recognizable selectable-text PDF layouts, and scanned PDF tables through local PaddleOCR/PP-StructureV3.
• File selection never inserts movements immediately. Detection, mapping, bounded preview, validation, warnings/errors, duplicate review, explicit confirmation, atomic persistence, and an import report are separate steps.
• Exact file hashes block renamed copies. Deterministic transaction fingerprints flag overlapping/equivalent movements without silently suppressing legitimate repeats; accepting suspected duplicates requires an explicit checkbox.
• Import history records source format, row/import/skip/error/duplicate counts, account, and timestamp. Imported movements persist across full Electron restart and feed the existing reconciliation engine.
• French decimal/date formats, UTF-8/Windows-1252 text, signed Amount and separate Debit/Credit layouts are covered. A 1,000-row fixture keeps preview rendering bounded.
• Legacy binary XLS is read locally through pinned xlrd 2.0.2. Corrupt workbooks and ambiguous PDF/OCR layouts fail with actionable messages rather than guessed accounting data. Scanned PDFs proceed only when PaddleOCR recognizes a bank header with a date and monetary columns; every row still requires mapping, validation, duplicate review, and explicit confirmation.
• The main shell and bank-review dialog are regression-tested across gradual desktop/laptop resizing and 80–125% zoom without page-level overflow hiding.

The historical 2.0 runtime delta and format status are recorded in the fix report and feature matrix.

This is the beginning of the README. Read the rest at the original. Read the full README ↗