Bash Stack Documentation

Quick Start

create a new bash stack app:

curl -SsL create.bashsta.cc | bash

Dependencies

there are a few dependencies:

• bash 4.0+
• tcpserver (from ucspi-tcp package)
• gnu coreutils

optionally…

• nodejs (for tailwind support)
• docker (for deployment)

Overview

Bash stack is an HTTP server and framework for building modern web applications (in bash).

Bash stack uses file-based routing. All of the application routes should exist as .sh files in the pages/ folder of the project.

Whenever an HTTP request is made, the framework will locate the corresponding script and execute it. Anything written to stdout by the script will be written to the HTTP response body.

Bash stack also pairs well with htmx, which is included by default. We strongly recommend familizarizing yourself with their examples before proceeding.

Showcase

These are some projects built using bash stack:

• Connect 4
• Wrizzle (multiplayer wordle)
• Jeopardy buzzer
• Github Issue Roulette
• Twitch ‘First’ Redeem
• Meme Maker Pro 2003 - Enterprise Edition
• Redemption Arc

Shipped something using bash stack? Send us a PR to add your project to the list!