explaingit

macarie/bun-tsup

Analysis updated 2026-08-08 · repo last pushed 2023-12-12

TypeScriptAudience · developerComplexity · 2/5DormantSetup · easy

TLDR

A small Bun plugin that fixes tsup builds hanging when using Bun's native build tools. It lets TypeScript bundling complete and exit cleanly.

Mindmap

mindmap
  root((repo))
    What it does
      Fixes tsup hang in Bun
      Makes builds exit cleanly
      Single-purpose plugin
    Tech stack
      TypeScript
      Bun runtime
      tsup build tool
    Use cases
      Bundle TS libraries
      Speed up builds with Bun
      Avoid manual workarounds
    Audience
      Bun developers
      TypeScript library authors
      tsup users
    Limitations
      Sparse README
      No deep technical docs

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

Fix hanging tsup builds when using the --bun flag in Bun

USE CASE 2

Bundle TypeScript libraries with tsup inside the Bun runtime without manual workarounds

USE CASE 3

Streamline developer workflows that combine Bun and tsup for faster builds

What is it built with?

TypeScriptBuntsup

How does it compare?

macarie/bun-tsup000madz000/rfid-attendance0xdevalias/sparkle
LanguageTypeScriptTypeScriptTypeScript
Last pushed2023-12-122024-07-222022-06-29
MaintenanceDormantDormantDormant
Setup difficultyeasyeasymoderate
Complexity2/52/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

Requires Bun runtime and tsup installed in your project.

In plain English

bun-tsup is a small plugin for Bun, the fast JavaScript runtime, that makes it easier to use a popular build tool called tsup. When developers write code in TypeScript, they often need to "build" it, meaning they translate their human-readable code into a streamlined version that computers can run efficiently. This plugin helps that building process happen smoothly inside the Bun environment. Normally, if you use Bun to run a build command, everything works as expected and finishes cleanly. However, if you specifically tell Bun to use its own internal build tools, which you do by adding a --bun flag, the process gets stuck and never exits. It just hangs there, keeping the program alive even after the work is done. This project fixes that annoying behavior so the build completes and shuts down properly. This is mainly for developers who already use Bun and tsup together in their projects. For example, if you are creating a TypeScript library and you want to use tsup to package it up for distribution, you might run into this hanging issue when you try to speed things up with Bun's native build capabilities. Instead of hunting down a workaround yourself, you can use this plugin to handle it automatically. The README is extremely sparse, so it does not go into detail about how the fix actually works under the hood or what specific mechanism causes the hang in the first place. It simply presents the problem and offers this tool as the solution. The project appears to be a focused, single-purpose utility designed to eliminate one specific friction point in an otherwise smooth developer workflow.

Copy-paste prompts

Prompt 1
Install bun-tsup in my TypeScript project and configure it so my tsup build stops hanging when I run it with the --bun flag
Prompt 2
Show me how to add the bun-tsup plugin to my tsup config so builds exit cleanly inside Bun
Prompt 3
Help me set up a tsup build for a TypeScript library using Bun and include the bun-tsup plugin to prevent the process from hanging

Frequently asked questions

What is bun-tsup?

A small Bun plugin that fixes tsup builds hanging when using Bun's native build tools. It lets TypeScript bundling complete and exit cleanly.

What language is bun-tsup written in?

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

Is bun-tsup actively maintained?

Dormant — no commits in 2+ years (last push 2023-12-12).

How hard is bun-tsup to set up?

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

Who is bun-tsup for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.