explaingit

mindon/biu

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 2/5Setup · easy

TLDR

A zero-config web bundler powered by Bun that takes HTML files with TypeScript/JavaScript, bundles and minifies them for production, and includes a dev server with live rebuild.

Mindmap

mindmap
  root((biu bundler))
    What it does
      Bundle HTML plus TS
      Minify HTML CSS JS
      Dev server
      Watch mode
    Features
      Smart module splitting
      Content hash filenames
      CDN caching offline
      Backend API routes
    Tech Stack
      Bun runtime
      TypeScript
      SCSS support
    Install
      curl one-liner
      Prebuilt binaries
      Self-compile
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Bundle a web project from a src/ folder into production-ready dist/ with minified HTML, CSS, and JS in a single command.

USE CASE 2

Run a local development server with automatic rebuild on file changes using biu --serve.

USE CASE 3

Add TypeScript API routes to a front-end project by placing handler files in a backend/ directory that map to URL paths.

USE CASE 4

Download all CDN-referenced scripts and stylesheets locally so the project works offline using --cdn-cache.

What is it built with?

TypeScriptBunHTMLCSSSCSS

How does it compare?

mindon/biuarashthr/hugo-flowargeneau12e/kairos-tx
Stars222
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatehard
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

In plain English

biu is a build tool for web projects that takes your HTML files and the TypeScript or JavaScript they reference, bundles them into a compressed, production-ready output, and optionally serves them locally during development. It is powered by Bun (a fast JavaScript runtime) and designed to require no configuration files. The typical workflow is to put your HTML and TypeScript or JavaScript files inside a src/ directory, then run biu --serve. It starts a local development server at localhost:3000, watches for file changes, and rebuilds automatically. When you are ready to deploy, the output lands in a dist/ folder containing optimized HTML and JS files ready for any static host. biu handles several things automatically. It identifies which JavaScript files are referenced in HTML and builds those as standalone modules, while unreferenced files are bundled inline. It minifies HTML, CSS, SCSS, and JavaScript, including JavaScript that appears inside HTML template literals. Output filenames include a content hash so browsers automatically pick up new versions after a deploy. Static assets in a static/ folder are copied through unchanged. There are also more advanced features. A backend/ directory can be used to add server-side API routes written in TypeScript, where each file maps to a URL path and named exports (GET, POST, and so on) handle matching HTTP methods. A CDN caching mode downloads externally referenced resources from CDN URLs and rewrites the project to load them locally, allowing projects to work offline. Dependency installation can also be automated. Installation is a one-line curl command for macOS, Linux, and WSL, or a PowerShell command for Windows. Prebuilt binaries are available without needing to install Bun. The project can also be compiled from source. No license is stated in the README.

Copy-paste prompts

Prompt 1
How do I set up biu for a new TypeScript web project? What folder structure does it expect and how do I start the dev server?
Prompt 2
Explain how biu decides which JS files become separate modules versus which ones get inlined into HTML. What does the ?? force-inline import suffix do?
Prompt 3
How do I add a POST endpoint to my biu project using the backend/ directory? Show a minimal TypeScript route handler example.
Prompt 4
Set up biu's --cdn-cache mode to download Bootstrap and Alpine.js from CDN locally so the project builds and runs fully offline.

Frequently asked questions

What is biu?

A zero-config web bundler powered by Bun that takes HTML files with TypeScript/JavaScript, bundles and minifies them for production, and includes a dev server with live rebuild.

What language is biu written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, HTML.

How hard is biu to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is biu for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub mindon on gitmyhub

Verify against the repo before relying on details.