Repository navigation
Forma 1.0.0
Forma turns a screenshot, a PDF or an existing report into a real DevExpress .repx. You attach the source, Gemini reads it, and you get three things in one response: a written spec, an in-browser mockup, and XtraReportsLayoutSerializer XML that downloads as a report file and opens in the DevExpress designer.
This is the first numbered release. The app has been live at https://openforma.web.app since 2026-09-08; 1.0.0 is the point where the version number catches up with what is already serving.
What it does
Intake. Images, PDFs and .repx files. PDFs are rasterised and have their text layer extracted, so exact strings survive. A folder of legacy reports can be queued and comes back as one .zip, one report per source file.
Generation. One structured response carries the spec, the layout JSON and the REPX, parsed against a response schema rather than hoped for. Streaming progress with pause and stop. A chat column for refining the result, with retry on overload and a plain statement of when to try again on a rate limit.
The REPX it writes. A real band skeleton: ReportHeader, PageHeader, a one-row Detail, ReportFooter, PageFooter. Data binding against a pasted schema (JSON row, CSV, CREATE TABLE or a list of names), using the data's own field names. Grouping with subtotals, sorting, typed parameters, calculated columns, conditional formatting, charts, gauges, cross-band rules, checkboxes, panels, shapes, a document map and a DRAFT watermark. Repeated appearances are hoisted to a style sheet. A margin the model drew as whitespace is declared as a real page margin. Every piece of syntax was measured against the DevExpress 20.1 serializer rather than written from the API docs.
Checks on the output. Ref values are made unique and ItemN restarts per collection, because either defect makes the designer drop content with no error. A REPX the model stopped writing part-way is detected at the parse and rebuilt from the layout. A REPX audit runs after every repair and reports what is still wrong in the status bar.
Seeing the result. Mockup drawn from the layout. Preview drawn from the downloaded REPX itself, paginated as it prints, with PDF export and drag-to-move, resize and retype directly on the page. A Revisions panel with a structural diff by control name. Eight DevExpress versions in the picker, 20.1 to 26.1, written into SerializerVersion.
Accounts. Sign in to save reports and their history to Firestore. Signed out, everything stays in the browser. Deleting an account removes the key vault with it, and the rules suite proves it.
Windows companion. tools/RepxDesigner opens a generated report in the real DevExpress designer from an Open in designer button, over a loopback listener. tools/RepxProbe asks DevExpress what a .repx really contains.
Security model
The app owns no Gemini key. Each user supplies their own at runtime, held in session storage and never written to disk; it can be encrypted into Firestore with AES-GCM under a passphrase. The browser calls Google directly, and a Content-Security-Policy with a strict connect-src is what makes a stolen key worthless to injected script. The deployed site serves no inline script except one hashed theme script, no third-party fonts and no analytics. Generation is deliberately not moved server-side.
Known limitations
- The report library (retrieval of house style from reports already written) is built and wired but has not been evaluated, and stays a proposal in
docs/proposals/rag.md. - RTL layout, stored-procedure names and the data-binding schema are supported in the pipeline but not yet exposed in the UI.
- The designer companion is Windows-only and needs a DevExpress 20.1 licence to build.
- Batch processes one file at a time, by design, to stay inside the user's Gemini quota.
- Preview cannot lay out every report the REPX can describe, and says so when it cannot.
Requirements
Node 20, 22 or 24 or later (21 and 23 are outside the supported range). A Gemini API key of your own. Java 21 only if you want to run the Firestore rules suite.
Licence
Apache-2.0.