Structure du projet
Le répertoire app/, text.config.ts et la CLI text.
Les dossiers dans app/ définissent les routes, et des fichiers spéciaux définissent l’interface de chaque route.
#Dossiers
| Dossier | Rôle |
|---|
app | Routes, layouts et gestionnaires de route |
lib | Modules partagés, sans route associée |
public | Ressources statiques |
#Fichiers de routage
| Fichier | Rôle |
|---|
layout.tsx | Interface partagée pour un segment |
page.tsx | Écran accessible par une route |
loading.tsx | Contenu de repli de Suspense |
error.tsx | Limite de capture des erreurs |
not-found.tsx | URL sans correspondance |
route.ts | Point de terminaison d’API |
app/├── layout.tsx → shared shell├── page.tsx → /├── sessions/│ ├── page.tsx → /sessions│ └── [id]/page.tsx → /sessions/:id└── api/health/route.ts → GET /api/health
#Routes dynamiques
| Dossier | URL | params |
|---|
[id] | /sessions/42 | { id: "42" } |
[...slug] | /docs/a/b | { slug: ["a", "b"] } |
#text.config.ts
import { defineConfig } from "@textjs/app";export default defineConfig({ title: "Acme", viewport: { width: 120, height: 36, theme: "geistDark" }, hints: [{ keys: "↑ ↓", label: "count" }],});
| Option | Valeur par défaut | Description |
|---|
title | "" | Titre de la page et du FocusPad |
viewport | adapté à la console, sinon 120×36 | responsive (true par défaut), dimensions de repli width × height, theme |
hints | [] | Deux ou trois touches affichées sur le FocusPad de la page |
action | press <first hint> | Action à effectuer une fois le focus obtenu, par exemple "type a prompt" |
devIndicators | true | Panneau de développement dans la console ([▼]) |
focusHint | true | « Cliquez sur la page pour utiliser le clavier » au-dessus de la dernière ligne de la console tant que la page n’a pas le focus |
rewrites | [] | Réécritures et proxys |
ansi | { cols: 80, rows: 24 } | Taille des frames pour curl et les clients terminal, ou false pour leur servir du HTML |
#CLI
| Commande | Description |
|---|
text dev | Serveur de développement avec Fast Refresh |
text build | Compilation de production |
text start | Mise à disposition de la compilation et des gestionnaires de route |
text run | Rendu de l’application dans un terminal (Terminal) |
text mcp | Mise à disposition de l’application pour les agents de programmation (MCP) |