Skip to content

Getting started

This walkthrough takes ten minutes and covers the essentials: at the end, you will have a table, a kanban view and a public form that writes into it.

Everything is organized by project: the selector at the top of the sidebar switches projects or creates one. In the sidebar, the + to the right of the filter creates a base. Give it a label — “Ventes” — and, if you like, a description, a color, an icon.

The base becomes a PostgreSQL schema: its physical name (b_t4z56fq_ventes) appears in the form and in the generated documentation.

From the base’s ⋯ menu: New table. Then add its fields from Schema — in that same menu — and its Field button:

FieldType
NomShort text
StatutSingle select — Nouveau, Qualifié, Gagné, Perdu
MontantCurrency
ÉchéanceDate
ClientRelation → Clients
NotesLong text (Markdown)

Later, a formula (DAYS([Échéance], TODAY())), a lookup (the client’s city) or a rollup (the total amount per client) are added the same way — see Tables and fields.

You can also import a file — an Excel workbook (.xlsx), a CSV or a JSON: the import guesses the types, lets you correct them, creates the table or fills an existing one, and tells you row by row what it rejects. From a workbook with several sheets, you choose the sheet; dates, amounts and checkboxes are read as Excel holds them, and a formula gives its value.

A base’s menu

The grid is edited like a spreadsheet: double-click or Enter to edit a cell, Esc to cancel. Filter combines conditions per field; sorting is done from the column header; Search…, on the right of the bar, searches all columns. Every change is saved immediately — and recorded in the history: Ctrl+Z undoes the last one.

The view selector, to the left of “Filter”, offers “All rows” and then your views. Create a kanban grouped by “Statut”: dragging a card from one column to another updates the row.

A kanban by status

Create a Form view, check the questions, then Share: choose “Public” and copy the link. Each response adds a row to the table, without giving the respondent any permission. Details in Shared forms.

The base’s ⋯ menu → SQL query: your tables are there, under their real names.

SELECT nom, statut, montant
FROM b_t4z56fq_ventes.opportunites
WHERE statut = 'gagne'
ORDER BY montant DESC;

Save files it under the tables, in the “Queries” section — for you, or for the whole base — and ⋯ → Create SQL view… turns it into a real PostgreSQL view, filed among the tables. Everyone reads them with their own permissions. See SQL queries and views.

It is the same from psql or your BI tool. See Direct SQL.

basedb is open-source software by Eodia, an AI-native software studio.