Build native apps with Tarve

Getting started

1. Install

   Tarve needs Bun 1.4+ on Windows x64 or Linux x64.

   bun add @tarve/core
   bun add -d typescript @types/bun

2. Configure TypeScript

   Point the JSX runtime at @tarve/core.

   {
     "compilerOptions": {
       "target": "ESNext",
       "module": "ESNext",
       "moduleResolution": "Bundler",
       "strict": true,
       "jsx": "react-jsx",
       "jsxImportSource": "@tarve/core",
       "types": ["bun", "@tarve/core/assets"]
     }
   }

3. Write a window

   import { Button, Column, Text, Window, createApp } from "@tarve/core";
   
   let count = 0;
   
   function App() {
     return (
       <Window title="Counter" width={520} height={360}>
         <Column flex={1} align="center" justify="center" gap={16}>
           <Text size={42} weight={700}>{count}</Text>
           <Button onClick={() => count++}>Increase</Button>
         </Column>
       </Window>
     );
   }
   
   const app = createApp(App);
   await app.ready;
   await app.closed;

4. Run and ship

   # runs the source directly, no build step
   bun app.tsx
   
   # Windows → .exe with the native runtime embedded
   bun run tarve build app.tsx --outfile dist/App.exe
   
   # cross-compile for Linux x64, no Rust toolchain needed
   bun run tarve build app.tsx --target linux-x64 --outfile dist/App

How rendering works

Components

Common props

Every component accepts these props in addition to its own.