Struttura del progetto
La directory app/, text.config.ts e la CLI text.
Le cartelle in app/ definiscono le route e i file speciali definiscono l’interfaccia di ogni route.
#Cartelle
| Cartella | Scopo |
|---|
app | Route, layout e route handler |
lib | Moduli condivisi, senza route |
public | Risorse statiche |
#File di routing
| File | Scopo |
|---|
layout.tsx | Interfaccia condivisa per un segmento |
page.tsx | Una schermata associata a una route |
loading.tsx | Fallback di Suspense |
error.tsx | Error boundary |
not-found.tsx | URL senza corrispondenza |
route.ts | Endpoint API |
app/├── layout.tsx → shared shell├── page.tsx → /├── sessions/│ ├── page.tsx → /sessions│ └── [id]/page.tsx → /sessions/:id└── api/health/route.ts → GET /api/health
#Route dinamiche
| Cartella | 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" }],});
| Opzione | Valore predefinito | Descrizione |
|---|
title | "" | Titolo della pagina e del FocusPad |
viewport | adattamento alla console, altrimenti 120×36 | responsive (valore predefinito true), fallback width × height, theme |
hints | [] | Due o tre tasti mostrati sul FocusPad della pagina |
action | press <first hint> | Cosa fare dopo aver ottenuto il focus, ad esempio "type a prompt" |
devIndicators | true | Dev Overlay nella console ([▼]) |
focusHint | true | «Fai clic sulla pagina per usare la tastiera» sopra l’ultima riga della console quando la pagina non ha il focus |
rewrites | [] | Riscritture e proxy |
ansi | { cols: 80, rows: 24 } | Dimensioni del frame per curl e client terminale, oppure false per fornire loro HTML |
#CLI
| Comando | Descrizione |
|---|
text dev | Server di sviluppo con Fast Refresh |
text build | Build di produzione |
text start | Pubblicazione della build e dei route handler |
text run | Rendering dell’app in un terminale (Terminale) |
text mcp | Accesso all’app per gli agenti di programmazione (MCP) |