Manual

The Neuridion manual

Everything, honestly: the book explains how the product thinks, the reference lists every command — each with its signature, and worked examples that are kept true by tests. Use the search above; it knows every heading and every command.

The book

Getting started

From an empty window to a running application — one sitting.

1 · A new project · 2 · Draw the schema · 3 · Windows, without writing them · 4 · Run · 5 · A line of JavaScript · 6 · Build
Schema & data

Tables, fields, relationships, computed columns — and what money is.

Tables and fields · Relationships · Computed fields · Money · Files and pictures · When the schema changes
Forms & windows

The canvas, the objects, styles, tabs — and the events between them.

The canvas · Styles · Bindings, and why there is no Save button · Windows and their kinds · Tabs and the Tab key · Events
Lists

One list everywhere — row actions, editable cells, footers, reordering.

One list, everywhere · What a list shows · Row actions — buttons nobody writes · Editable cells · Find and Sort — two windows, not one · Reordering
Calendar

Appointments you can drag — month, week, day, agenda, or a board of rooms.

A list in another shape · Office hours · Five views, and one of them is a board · The whole loop, with no script at all · No recurring appointments — on purpose · What a script can ask, and tell · Drag something in from a list · On paper, and in somebody else’s calendar · The events · Somebody else moves one
Scripts & events

Where code runs, what each event means, and what a script may touch.

Where code lives · Variables · The event object · Timing · Errors · The editor knows your schema
Variables

What a window remembers between two events, and a session for as long as it runs.

The three scopes · Declare them, and the editor helps · Writing one that was never declared · It is memory, not a transaction
Reports & printing

The report editor, form letters, labels — and printing from a list.

One printing engine · The editor · A chart on the page · Form letters and labels · Two shelves · From a script, and from every list
Import & export

CSV, JSON, XML — mapping, key fields, and running it again next month.

The import window · Importing twice — the key field · Exports · Presets · Relationships in imported data
Backups & restore

Automatic copies, packages, passwords — and what a restore really does.

The package · Automatic, rotated, cheap · Where they go, and the honest failure · A password of its own · Restore is a restart
Building & shipping

Test and release builds, signing, notarization — and the license.

Test build, release build · Products · What comes out · The application itself — its menu, its About, its icon · Starting data, stamp, updates
Languages & translations

Your application in your customer's language — typed as always, filled by the Mac, and what a human translated the machine never touches again.

You work as you always did · One entry per table: Translations · Translation as data with a memory · Sentences in scripts: language.text · Building and running · What is never translated
Client / Server

One server, a client on every desk — pairing, locks, backups, updates.

The shape · Finding and pairing · Locks · The status window · Losing the connection · New desks and new versions · Over the internet · Under load — measured
Record locking

Two people, one record — how it is handled automatically, and by hand from a script.

Single-user: nothing to think about · Automatic — the whole model, and you write no code for it · By hand — from a script
Performance — how it is fast

Interpreted and compiled at once — the three compilers you never run, and the measured numbers.

“Nothing is compiled” — which is half true, and the whole truth is better · 1 · Your scripts: JavaScriptCore compiles the hot code · 2 · The bridge: built once, crossed a million times a second · 3 · Your queries: compiled to SQL, run by SQLite · What that adds up to — measured · Measure it yourself
Debugging

Breakpoints, stepping, the query log — on real data.

Debug is Run, plus truth · Breakpoints · Stepping and seeing · The query log · Watching one expression, and who called this · The post-mortem
Limits — the honest chapter

What Neuridion deliberately does not do, and why.

No Undo — yet · “Protected”, never “uncrackable” · macOS, and only macOS · Not in the Mac App Store — yet · The internet is a VPN · No users, no permissions — on purpose · What never changes

The reference

The form objects

All 27 kinds a window is made of — what each one does, and its events.

The API, group by group

Every command lives in a group — the only free names are the data objects database, record, form, event, and log. English, camelCase, no abbreviations, and everything is synchronous: a script reads top to bottom, and a call has its answer on the next line.

database, records & queries

The data itself. database.customers is a table, a query is a chain that stays lazy until something asks, and a record is an object — the same row is always the same object. The badges say what each command means for the wire in a Client/Server pair — green: only an answer returns; red: rows or bytes travel — with measured times (localhost; an office LAN adds ~0.3–3 ms per round trip). Single-user applications have no wire and pay none of it.

23 commands · 23 worked examples
form & event

Inside a form script, form is this window — its objects by name, its record — and event says what just happened. Both exist only where they mean something: a menu script has no form.

6 commands · 6 worked examples
forms

Windows in general — the plural is the group, the singular (form) is the window you are standing in.

7 commands · 7 worked examples
messages

Talking to the person at the keyboard — dialogs, sounds, progress. Everything here blocks the script until it is answered, which is what a synchronous API means.

7 commands · 7 worked examples
application

The application itself — what it is called, which version it is, and the one way to end it.

7 commands · 7 worked examples
security

Passwords and the keychain. Deliberately small: who may do what is your application's question — these are the tools to answer it with.

6 commands · 6 worked examples
reports

Printing goes through reports — the ones you designed, so there is one printing engine, not two.

3 commands · 3 worked examples
files

Folders, dialogs, reading and writing text — and the permissions macOS puts between an application and the disk.

17 commands · 17 worked examples
xml

XML in and out, as a tree of plain objects.

2 commands · 2 worked examples
language

The Mac reads for you — on the customer's own machine, nothing leaves it.

5 commands · 5 worked examples
ai

A model answers — Apple Intelligence on the Mac by default, or a provider you configure. Synchronous like everything else.

6 commands · 6 worked examples
system

The machine and the person at it — language, appearance, clipboard.

15 commands · 15 worked examples
log

The console, and the application's log file.

1 commands · 1 worked examples