When I rebuilt my site, space.la, I wanted static pages, a few server-rendered and incrementally regenerated routes, markdown content, real SEO and a single heavy interactive island. I didn't want a large framework underneath it.
So I wrote one in my own language. Orbit is a hybrid SSG / SSR / ISR, markdown-first web framework, and its core is written in Tish. It's MIT licensed and on npm as @tishlang/orbit.
This post covers what Orbit does, what Tish is, and what it was like to build a framework in a young language.
What Tish is
Tish is a TypeScript- and JavaScript-compatible language implemented in Rust. The syntax will look familiar: functions, arrow functions, async/await, modules, JSX. A few semantics are deliberately stricter:
-
No
undefined. There is onlynull, and equality is strict-only. -
Secure by default.
http,fsandprocessare opt-in feature gates. -
Gradual typing. Type checking is opt-in (
--check warn|error). On the native backend, typed code compiles down to native Rust types. The README reports speedups of up to ~140× on its own perf-gauntlet benchmarks.
The same source can run several ways:
- on a tree-walking interpreter or a bytecode VM;
- compiled to a standalone native binary, with no runtime needed on the target machine;
- compiled to WASM/WASI;
- compiled to JavaScript.
It comes with tooling: a formatter, a linter with SARIF output, a language server, a tree-sitter grammar and a VS Code extension. Install it with brew install tish or npm i @tishlang/tish, or try it in the browser at tish.sh.
What Orbit does
Orbit will feel familiar if you've used a modern meta-framework:
-
File-based routing.
pages/*.tishfiles written in JSX, with dynamic[slug]and catch-all[...path]routes. -
Nested layouts with
_layout.tish. - Markdown collections with frontmatter: blog posts, portfolio entries, anything.
- Rendering mode per route. Each page exports one:
export let render = 'static' // or 'server', or 'isr'
export let revalidate = 3600 // for ISR
-
Streaming SSR.
defer()boundaries resolve out of order, so slow data doesn't block the whole page. -
Islands.
island(name, props, { load: 'idle' | 'visible' | 'eager' })ships JavaScript only where it's needed. Islands are separate ES modules and can themselves be written in Tish. - A built-in utility-CSS engine. Tailwind-style classes with variants and arbitrary values, generated by Orbit itself, so there's no separate PostCSS toolchain.
- SEO out of the box. Sitemap, robots.txt, RSS/Atom feeds, and Open Graph, Twitter and JSON-LD tags are all generated for you.
-
Deploy targets. Vercel's Build Output API (
orbit build --target vercel), or a plain Node server with a TTL cache. - Dev server with live reload.
Start a site with:
npx @tishlang/orbit new my-site
What's actually written in Tish
Orbit's core is Tish:
- the router;
- the markdown and frontmatter parsers;
- the renderer;
- SEO generation;
- the CSS engine;
- the server handler.
The CLI glue and the Node/Vercel adapters are small .mjs files. A host shim (fetch, readFile, env) keeps the core portable, so the same code runs natively under tish run and under Node or Vercel through Tish's JavaScript target.
Building a real framework was the best test Tish has had. A router, a markdown parser and a CSS generator stress string handling, modules, async code and JSX in exactly the ways a toy example never does.
Orbit in production: space.la
space.la is my personal site, rebuilt as a DDR-style song wheel of every project I've shipped. On Orbit it uses:
- markdown collections for the blog, portfolio, code snippets, cocktails and resume;
- static prerendering for every page, so search engines, screen readers and browsers without WebGPU all get real HTML;
- ISR for the live project timeline;
- streaming SSR for search;
- a single island that holds the entire WebGPU game layer;
- Vercel Build Output, deployed with no framework preset.
Status
Orbit is early (0.1.x) and Tish is on 4.x. Both are MIT licensed, and both are moving fast. If you build something with them, or something breaks, issues and PRs are welcome.
-
Orbit: github.com/tishlang/orbit ·
npx @tishlang/orbit new my-site - Tish: tishlang.com · github.com/tishlang/tish · tish.sh
- See it running: space.la
Top comments (0)