Projektstruktur
Das Verzeichnis app/, text.config.ts und die text-CLI.
Ordner in app/ definieren Routen, und spezielle Dateien definieren die UI für jede Route.
#Ordner
| Ordner | Zweck |
|---|
app | Routen, Layouts und Route-Handler |
lib | Gemeinsam genutzte Module ohne Routing |
public | Statische Ressourcen |
#Routing-Dateien
| Datei | Zweck |
|---|
layout.tsx | Gemeinsame UI für ein Segment |
page.tsx | Über eine Route erreichbare Ansicht |
loading.tsx | Fallback für Suspense |
error.tsx | Error Boundary |
not-found.tsx | URLs ohne passende Route |
route.ts | API-Endpunkt |
app/├── layout.tsx → shared shell├── page.tsx → /├── sessions/│ ├── page.tsx → /sessions│ └── [id]/page.tsx → /sessions/:id└── api/health/route.ts → GET /api/health
#Dynamische Routen
| Ordner | 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 | Standardwert | Beschreibung |
|---|
title | "" | Titel der Seite und des FocusPad |
viewport | an Konsole anpassen, sonst 120×36 | responsive (Standardwert true), Fallback width × height, theme |
hints | [] | Zwei oder drei Tasten, die auf dem FocusPad der Seite angezeigt werden |
action | press <first hint> | Aktion nach dem Fokussieren, z. B. "type a prompt" |
devIndicators | true | Dev-Overlay in der Konsole ([▼]) |
focusHint | true | „Klicke auf die Seite, um die Tastatur zu verwenden“ über der letzten Zeile der Konsole, solange die Seite keinen Fokus hat |
rewrites | [] | Rewrites und Proxys |
ansi | { cols: 80, rows: 24 } | Frame-Größe für curl und Terminal-Clients, oder false, um ihnen HTML auszuliefern |
#CLI
| Befehl | Beschreibung |
|---|
text dev | Entwicklungsserver mit Fast Refresh |
text build | Produktionsbuild |
text start | Build und Route-Handler bereitstellen |
text run | Die App in einem Terminal rendern (Terminal) |
text mcp | Die App für Coding-Agenten bereitstellen (MCP) |