TS-Games

Custom framework/build system for simple single-file TypeScript games.

Installing dependencies

bun install

bun start

Navigate to http://localhost:3000 to see the list of your games. Game rebuilds on each reload.

bun run build <project>

Will create <project>.html in dist folder.

Or to select project from list:

bun run build

Bun ♥
TypeScript
Building into single .html file without any dependencies, all assets are inlined as data-urls.
- src/games/<yourgame>/assets/favicon.ico is used as page icon if present.
TSX supported with Preact, because it's lightweight.

Import images as HTMLImageElement

PNG & JPG

import spritesheet from './assets/spritesheet.png';
console.log(spritesheet); // <img src="data:..." />

Import audio as HTMLAudioElement

WAV, MP3 & OGG

import heal from './assets/heal.ogg';
console.log(heal); // <audio src="data:..." />
heal.play()

Import CSS

CSS modules is supported

import styles from './assets/styles.module.css';
console.log(styles.awoo); // G7sddg_awoo

export default <div className={styles.root}></div>;

Modern CSS features are transpiled

Nested CSS

.root {
    display: flex;
    .row {
        display: flex;
        flex-direction: row;
    }
}

Import fonts (see example in src/common/assets/vga.font.css)
```
import "./assets/lcd.font.css";
```

AssemblyScript support (TypeScript-like language compiled into WebAssembly)
- Example: src/games/playground/awoo.wasm.ts
- Triggered by file name *.wasm.ts
Import *.c/*.cpp files (compile to wasm on the fly)
- Example: src/games/life/life.c
- To use, clang and wasm toochain should be present in the system
```
sudo apt install clang lld wabt
```
- Supports only function exports & memory
  - EXPORT(jsName) void c_function();
- No stdlib

Make .env file

PUBLISH_LOCATION=ssh.example.com:/var/www/games/
PUBLISH_URL=https://example.com/