Структура проекта
Каталог app/, файл text.config.ts и CLI text.
Папки в app/ определяют маршруты, а специальные файлы определяют интерфейс каждого маршрута.
#Папки
| Папка | Назначение |
|---|
app | Маршруты, макеты и обработчики маршрутов |
lib | Общие модули без маршрутов |
public | Статические ресурсы |
#Файлы маршрутизации
| Файл | Назначение |
|---|
layout.tsx | Общий интерфейс сегмента |
page.tsx | Экран, доступный по маршруту |
loading.tsx | Запасной интерфейс Suspense |
error.tsx | Граница ошибок |
not-found.tsx | URL без соответствующего маршрута |
route.ts | Конечная точка API |
app/├── layout.tsx → shared shell├── page.tsx → /├── sessions/│ ├── page.tsx → /sessions│ └── [id]/page.tsx → /sessions/:id└── api/health/route.ts → GET /api/health
#Динамические маршруты
| Папка | 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" }],});
| Параметр | По умолчанию | Описание |
|---|
title | "" | Заголовок страницы и FocusPad |
viewport | по размеру консоли, иначе 120×36 | responsive (по умолчанию true), запасной размер width × height, theme |
hints | [] | Две или три клавиши, показанные на FocusPad страницы |
action | press <first hint> | Действие после получения фокуса, например "type a prompt" |
devIndicators | true | Оверлей разработчика в консоли ([▼]) |
focusHint | true | «Щёлкните по странице, чтобы использовать клавиатуру» над последней строкой консоли, пока страница не в фокусе |
rewrites | [] | Перезаписи и прокси |
ansi | { cols: 80, rows: 24 } | Размер кадра для curl и терминальных клиентов или false, чтобы отдавать им HTML |
#CLI
| Команда | Описание |
|---|
text dev | Сервер разработки с Fast Refresh |
text build | Сборка для продакшена |
text start | Обслуживание сборки и обработчиков маршрутов |
text run | Рендеринг приложения в терминале (Терминал) |
text mcp | Предоставление приложения агентам программирования (MCP) |