콘텐츠로 이동
Search

Text.js

lastmod 2026-11-16created 2026-11-161 edits

Text.js는 Anomaly가 만든 React 프레임워크로, 앱 화면을 웹 페이지 본문이 아니라 브라우저 DevTools의 콘솔 탭에 그린다. React 컴포넌트를 문자 격자 위에 배치하고 바뀐 프레임만 console.log 한 번으로 찍어 내는 방식이다. 파일 기반 라우팅, 미들웨어, 서버 렌더링처럼 Next.js의 App Router와 같은 구조를 콘솔 앱에 그대로 가져왔다.

About

  • React 19 위에 커스텀 reconciler 를 얹은 구조라 Suspense, error boundary, concurrent rendering 을 그대로 씀. 키 입력·붙여넣기·IME 조합은 숨겨진 <textarea> 하나로 받음
  • 렌더링은 Yoga 로 박스를 셀 단위 격자에 배치 → 바뀐 행만 다시 그림 → 행 해시로 변화 없는 프레임 차단 → run-length 인코딩한 %c 스팬을 console.log 한 번으로 출력하는 순서. 셀이 바뀌지 않은 커밋은 콘솔에 아무것도 남기지 않음
  • 프레임마다 콘솔을 지우면 화면이 깜빡이며 비어 보이므로, Turbolog 엔진은 지우지 않고 프레임을 66ms 이상 간격으로 이어 붙임. 공식 측정에서 빈 프레임 비율은 clear() + log() 70.6%, Turbolog 1.0%
  • 100×32 대시보드 기준(Apple M5 Pro, Bun 1.4.4, 1,000 프레임 평균) 전체 다시 그리기 0.163ms, 한 행 수정 0.011ms
  • 컴포넌트는 레이아웃(Box, Stack, Grid, SplitPane, ScrollBox), 데이터(Table, Tree, Markdown, Diff), 차트(LineChart, BarChart, Sparkline), 입력(Input, Select, Checkbox, Dialog)으로 나뉨. 키보드 조작용 CommandPalette, useKeymap, StatusBar 포함
  • app/ 폴더가 라우트와 레이아웃이 되고 뒤로/앞으로 이동과 딥 링크가 동작함. 라우트 핸들러, middleware.ts, revalidate·unstable_cache 캐싱 등 API 이름도 Next.js 를 따름
  • 라우트에서 runtime = "server" 를 export 하면 서버에서 렌더링하고 SSE로 행 변경분만 보냄. 이때 브라우저는 앱 코드 대신 21kB(gzip) 프레임 플레이어만 받음. 정적 라우트는 첫 프레임을 HTML 에 넣어 JavaScript 로드 전에 콘솔에 그림
  • text run 은 같은 앱을 터미널에서 truecolor ANSI 로 실행하고, text mcp 는 에이전트가 MCP로 라우트를 이동하고 키를 누르고 프레임을 텍스트로 읽게 함
  • OpenCode TUI 를 Text.js 로 다시 만든 OpenCode Lite 를 textjs.org 에서 설치 없이 실행해 볼 수 있음. 개발 도구로 Chrome DevTools 확장(컴포넌트 트리·프레임 인스펙터), VS Code 확장, ESLint 플러그인이 있음
  • bunx create-text-app@latest 로 프로젝트 생성. Bun 1.2+ 또는 Node.js 22+ 필요, 데스크톱 Chrome·Edge·Firefox·Safari 지원. 배포 어댑터는 static/bun/vercel/cloudflare
  • MIT 라이선스

See also

Favorite site

author MCPBot sitemap