Showcase
The apps that prove Quantum: each one is in the repository, runs in CI, and is written in .q files with no JavaScript. The screenshots are taken from the apps running (scripts/showcase-screenshots.py); the AI apps answer through a stand-in model server, so no model is needed to reproduce them.
Tasks (Tarefas)
A task list in ui:*: a form validated by its action, finish and delete buttons, a filter from the address, a table that sorts and edits its cells against the schema, an edit form generated from the table, and the history of every change. The same pages run in the terminal and in a desktop window. Its content is in Portuguese; the tutorial builds it in English.
| Demonstrates | Actions and forms, Database, UI, Tests |
| SPEC rules it cites | DB-8, DB-10, DB-11, UI-2, UI-10, UI-13 |
| Size | 3 pages, 164 lines of .q, 0 lines of JavaScript |
| Tested by | 13 quantum test tests, tests/apps/test_tarefas.py, tests/apps/test_tarefas_browser.py, tests/apps/test_tarefas_console.py, tests/apps/test_tarefas_desktop.py |
| Source | projects/tarefas |
Tags it uses (26)
q:action q:component q:else q:if q:loop q:param q:query q:redirect q:set ui:alert ui:badge ui:button ui:column ui:form ui:hbox ui:history ui:input ui:link ui:pager ui:panel ui:section ui:select ui:table ui:text ui:vbox ui:window
Blog
A blog over SQLite with pages that are files (post/[slug].q), categories, search, comments, a login and an admin area that creates and edits posts in a transaction.
| Demonstrates | Pages and routes, Actions and forms, Database, Authentication |
| SPEC rules it cites | ACT-7, DB-9, ROUTE-2, ROUTE-4, UI-11, UI-12 |
| Size | 11 pages, 963 lines of .q, 0 lines of JavaScript |
| Tested by | 16 quantum test tests, tests/apps/test_blog.py |
| Source | projects/blog |
Tags it uses (13)
q:action q:component q:else q:if q:import q:loop q:param q:query q:redirect q:set q:transaction ui:input ui:pager
Helpdesk
Open a ticket with an attachment, checked by size and type, stored outside the public folder and served only through its ticket; the team is told by mail.
| Demonstrates | Actions and forms, Files and mail, UI |
| SPEC rules it cites | CFG-1, FILE-2, MAIL-1 |
| Size | 3 pages, 144 lines of .q, 0 lines of JavaScript |
| Tested by | tests/apps/test_helpdesk.py, tests/apps/test_helpdesk_browser.py |
| Source | projects/helpdesk |
Tags it uses (22)
q:action q:component q:else q:file q:if q:mail q:param q:query q:redirect q:set ui:alert ui:button ui:column ui:form ui:header ui:input ui:link ui:panel ui:table ui:text ui:vbox ui:window
Bank transfer
Money moves between two accounts inside one transaction: an overdraft is refused before anything runs, and if any step of the transfer fails nothing moves. The page says why a transfer was refused.
| Demonstrates | Actions and forms, Database |
| SPEC rules it cites | DB-4 |
| Size | 1 page, 138 lines of .q, 0 lines of JavaScript |
| Tested by | 6 quantum test tests |
| Source | projects/bank-transfer |
Tags it uses (8)
q:action q:component q:if q:loop q:param q:query q:redirect q:transaction
Docs assistant
Ask the Quantum guide a question: the answer comes only from the guide, cites its sources, and arrives as the model writes it. A question the guide does not cover is not sent to the model at all.
| Demonstrates | AI |
| SPEC rules it cites | IA-5, IA-6, IA-7, IA-9 |
| Size | 1 page, 63 lines of .q, 0 lines of JavaScript |
| Tested by | tests/apps/test_docs_assistant.py |
| Source | projects/docs-assistant |
Tags it uses (25)
q:action q:component q:else q:elseif q:if q:knowledge q:llm q:message q:param q:redirect q:set q:source ui:alert ui:button ui:form ui:hbox ui:header ui:input ui:item ui:list ui:panel ui:stream ui:text ui:vbox ui:window
Shop agent
An agent answers questions about a shop from its database through a few parameterized queries. The model never writes SQL, and every call it made is shown next to the answer.
| Demonstrates | AI, Database |
| SPEC rules it cites | IA-4, IA-5 |
| Size | 1 page, 106 lines of .q, 0 lines of JavaScript |
| Tested by | tests/apps/test_shop_agent.py |
| Source | projects/shop-agent |
Tags it uses (26)
q:action q:agent q:component q:else q:execute q:function q:if q:instruction q:param q:query q:redirect q:return q:set q:tool ui:alert ui:button ui:form ui:hbox ui:header ui:input ui:item ui:list ui:panel ui:text ui:vbox ui:window
Chat
A small chat room: join with a name, post messages, see who is online, with the room kept in the application scope.
| Demonstrates | Actions and forms, How a page runs |
| SPEC rules it cites | ACT-9, EXEC-3 |
| Size | 2 pages, 155 lines of .q, 0 lines of JavaScript |
| Tested by | 4 quantum test tests |
| Source | projects/quantum-chat |
Tags it uses (8)
q:action q:component q:else q:if q:loop q:param q:redirect q:set