Démarrage rapide

Ce guide vous mène d'un fichier vide à une application Sovrium opérationnelle. Choisissez l'approche qui correspond à votre flux de travail : un fichier YAML piloté par le CLI, ou un projet TypeScript pour un typage complet.

Choisissez votre approche

Sovrium prend en charge deux formats de configuration. Le YAML reste simple ; le TypeScript ajoute un typage complet et l'autocomplétion.

Option A : YAML + CLI

La voie la plus simple. Installez le CLI Sovrium, rédigez une configuration YAML et démarrez le serveur :

Installer le CLI — Installez le binaire Sovrium pour obtenir la commande sovrium. Homebrew, Docker et Scoop sont également disponibles sur la page Installation.
```
curl -fsSL https://sovrium.com/install | sh
```
Créer un fichier de configuration — Créez un fichier app.yaml avec la configuration valide la plus simple : juste un nom.
```
name: my-app
```

Ajouter des tables de données — Définissez vos modèles de données avec des champs typés, des options et de la validation.

name: my-app

tables:
  - id: 1
    name: tasks
    fields:
      - id: 1
        name: title
        type: single-line-text
        required: true
      - id: 2
        name: status
        type: single-select
        options: [To Do, In Progress, Done]

Démarrer le serveur — Lancez le serveur de développement et rendez-vous sur http://localhost:3000 pour voir votre application.
```
sovrium start app.yaml
```

Enrichissez au fur et à mesure. Commencez petit avec uniquement des tables. Puis ajoutez progressivement le thème, l'authentification, les pages et l'analytique à mesure que vos besoins grandissent.

Option B : TypeScript

Vous préférez le typage ? Rédigez la configuration en TypeScript avec une autocomplétion complète, puis exécutez-la avec le même CLI :

Ajouter les définitions de types — Installez le paquet sans dépendance @sovrium/types comme dépendance de développement, uniquement pour l'autocomplétion dans l'IDE.
```
bun add -d @sovrium/types
```
Créer app.ts — Enveloppez votre configuration dans defineConfig() comme export par défaut, en commençant par un simple nom.
```
import { defineConfig } from '@sovrium/types'

export default defineConfig({
  name: 'my-app',
})
```

Ajouter des tables de données — Enrichissez la configuration avec des champs typés, des options et de la validation, avec une autocomplétion complète.

import { defineConfig } from '@sovrium/types'

export default defineConfig({
  name: 'my-app',
  tables: [
    {
      id: 1,
      name: 'tasks',
      fields: [
        {
          id: 1,
          name: 'title',
          type: 'single-line-text',
          required: true,
        },
        {
          id: 2,
          name: 'status',
          type: 'single-select',
          options: ['To Do', 'In Progress', 'Done'],
        },
      ],
    },
  ],
})

Démarrer le serveur — Lancez le même CLI sur votre fichier app.ts et rendez-vous sur http://localhost:3000 pour voir votre application.
```
sovrium start app.ts
```

Pourquoi TypeScript ? TypeScript offre l'autocomplétion pour chaque propriété et la validation des types de champs à la compilation. Idéal pour les développeurs qui préfèrent le code aux fichiers de configuration.

Et ensuite ?

Maintenant que votre application est opérationnelle, explorez la référence du schéma pour ajouter davantage de fonctionnalités :

Concepts fondamentaux : l'anatomie d'une application Sovrium
Vue d'ensemble du schéma : les 18 propriétés racine expliquées
Vue d'ensemble des tables : 49 types de champs, permissions, index
Thème : couleurs, polices, espacement et jetons de design
Vue d'ensemble des pages : environ 80 types de composants pour des pages rendues côté serveur

Dernière mise à jour 17 juillet 2026

← PrécédentInstallation Suivant →Concepts fondamentaux