Estructura del proyecto
El directorio app/, text.config.ts y la CLI text.
Las carpetas de app/ definen las rutas, y los archivos especiales definen la interfaz de cada ruta.
#Carpetas
| Carpeta | Propósito |
|---|
app | Rutas, layouts y manejadores de ruta |
lib | Módulos compartidos, sin ruta |
public | Recursos estáticos |
#Archivos de enrutamiento
| Archivo | Propósito |
|---|
layout.tsx | Interfaz compartida para un segmento |
page.tsx | Una pantalla accesible mediante una ruta |
loading.tsx | Contenido alternativo de Suspense |
error.tsx | Límite de errores |
not-found.tsx | URLs sin coincidencia |
route.ts | Endpoint de API |
app/├── layout.tsx → shared shell├── page.tsx → /├── sessions/│ ├── page.tsx → /sessions│ └── [id]/page.tsx → /sessions/:id└── api/health/route.ts → GET /api/health
#Rutas dinámicas
| Carpeta | 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" }],});
| Opción | Valor predeterminado | Descripción |
|---|
title | "" | Título de la página y de FocusPad |
viewport | ajustado a la consola o, en su defecto, 120×36 | responsive (por defecto true), dimensiones alternativas width × height, theme |
hints | [] | Dos o tres teclas que se muestran en el FocusPad de la página |
action | press <first hint> | Qué hacer una vez obtenido el foco, p. ej. "type a prompt" |
devIndicators | true | Panel de desarrollo en la consola ([▼]) |
focusHint | true | «Haz clic en la página para usar el teclado» sobre la última fila de la consola mientras la página no tiene el foco |
rewrites | [] | Reescrituras y proxies |
ansi | { cols: 80, rows: 24 } | Tamaño del fotograma para curl y clientes de terminal, o false para servirles HTML |
#CLI
| Comando | Descripción |
|---|
text dev | Servidor de desarrollo con Fast Refresh |
text build | Compilación de producción |
text start | Servir la compilación y los manejadores de ruta |
text run | Renderizar la app en una terminal (Terminal) |
text mcp | Servir la app a agentes de programación (MCP) |