Struktur proyek
Direktori app/, text.config.ts, dan CLI text.
Folder di app/ menentukan route, dan file khusus menentukan UI untuk setiap route.
#Folder
| Folder | Fungsi |
|---|
app | Route, layout, dan route handler |
lib | Modul bersama, tidak dijadikan route |
public | Aset statis |
#File routing
| File | Fungsi |
|---|
layout.tsx | UI bersama untuk suatu segmen |
page.tsx | Layar yang dapat diakses melalui route |
loading.tsx | Fallback Suspense |
error.tsx | Error boundary |
not-found.tsx | URL yang tidak cocok |
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 dinamis
| 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" }],});
| Opsi | Nilai default | Deskripsi |
|---|
title | "" | Judul halaman dan FocusPad |
viewport | sesuaikan dengan konsol, jika tidak 120×36 | responsive (default true), fallback width × height, theme |
hints | [] | Dua atau tiga tombol yang ditampilkan pada FocusPad halaman |
action | press <first hint> | Tindakan setelah mendapat fokus, misalnya "type a prompt" |
devIndicators | true | Dev Overlay di dalam konsol ([▼]) |
focusHint | true | “Klik halaman untuk menggunakan keyboard” di atas baris terakhir konsol saat halaman tidak memiliki fokus |
rewrites | [] | Rewrite dan proksi |
ansi | { cols: 80, rows: 24 } | Ukuran frame untuk curl dan klien terminal, atau false untuk menyajikan HTML kepada klien tersebut |
#CLI
| Perintah | Deskripsi |
|---|
text dev | Server pengembangan dengan Fast Refresh |
text build | Build produksi |
text start | Sajikan build dan route handler |
text run | Render aplikasi di terminal (Terminal) |
text mcp | Sajikan aplikasi kepada agen pemrograman (MCP) |