Overview

Provides a Bun demo with minimal (and selectable) set of dependencies.

See blog post for more information.

Usage

To run once, in an empty directory:

bunx @flydotio/bun-demo@latest

To enable rerunning with different options, install via:

bun add @flydotio/bun-demo --dev

Then you can rerun as many times as desired using:

bunx bun-demo

General Option:

• --force - overwrite existing files
• --cjs - use require (cjs) instead of imports (es6)

Templating Options:

• --ejs - use Embedded JavaScript templating (ejs)
• --mustache - use mustache templates

Alternate Web Server

• --express - use express web server

Database Options:

• --monbodb - use mongodb
• --postgresql - use postgresdb
• --sqlite - use sqlite3

ORM Options:

• --drizzle - use drizzle ORM for databases. Implies typescript.
• --knex - use knex ORM for databases
• --prisma - use prisma ORM for databases

WebSocket:

• --websocket - use websockets for real-time updates
• --htmx - use htmx for socket updates
• --redis - use redis pub/sub

Popular builders

• --tailwindcss - use tailwindcss
• --typescript - generate typescript

Testing

A testing strategy is evolving. The combinatorics of the above options are mind boggling!

What tests we have can be run with npm test. This runs a series of tests defined in test.json, and compares the results to previously captures test/results.

Capturing new test results can be accomplished by running npm run test:capture. Review the results before committing.

Known bugs/limitations:

• When rerunning this tool, files that were previously created but no longer needed are removed. This does not include outputs in the build directory for example.

• This tool does not install or set up Postgres or Mongodb databases for you locally.

• This tool does not set environment variables or update your .env file.