Struktura projektu
Katalog app/, plik text.config.ts i CLI text.
Foldery w app/ definiują trasy, a pliki specjalne definiują interfejs każdej trasy.
#Foldery
| Folder | Przeznaczenie |
|---|
app | Trasy, layouty i handlery tras |
lib | Współdzielone moduły bez tras |
public | Zasoby statyczne |
#Pliki routingu
| Plik | Przeznaczenie |
|---|
layout.tsx | Wspólny interfejs segmentu |
page.tsx | Ekran dostępny pod trasą |
loading.tsx | Interfejs zastępczy Suspense |
error.tsx | Granica błędów |
not-found.tsx | Niedopasowane adresy URL |
route.ts | Punkt końcowy API |
app/├── layout.tsx → shared shell├── page.tsx → /├── sessions/│ ├── page.tsx → /sessions│ └── [id]/page.tsx → /sessions/:id└── api/health/route.ts → GET /api/health
#Trasy dynamiczne
| Folder | 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" }],});
| Opcja | Wartość domyślna | Opis |
|---|
title | "" | Tytuł strony i komponentu FocusPad |
viewport | dopasowanie do konsoli, w przeciwnym razie 120×36 | responsive (domyślnie true), rozmiar zastępczy width × height, theme |
hints | [] | Dwa lub trzy klawisze wyświetlane w komponencie FocusPad na stronie |
action | press <first hint> | Czynność po uzyskaniu fokusu, np. "type a prompt" |
devIndicators | true | Nakładka deweloperska w konsoli ([▼]) |
focusHint | true | „Kliknij stronę, aby używać klawiatury” nad ostatnim wierszem konsoli, gdy strona nie ma fokusu |
rewrites | [] | Reguły przepisywania i proxy |
ansi | { cols: 80, rows: 24 } | Rozmiar klatki dla curl i klientów terminalowych lub false, aby serwować im HTML |
#CLI
| Polecenie | Opis |
|---|
text dev | Serwer deweloperski z Fast Refresh |
text build | Kompilacja produkcyjna |
text start | Serwowanie skompilowanej aplikacji i handlerów tras |
text run | Renderowanie aplikacji w terminalu (Terminal) |
text mcp | Udostępnianie aplikacji agentom programistycznym (MCP) |