wasmdash

README

wasmdash

A self-hosted aesthetically pleasing, hackable, no bullshit dashboard in a single file.

No tracking, no premium features, no bullshit, just a simple dashboard.

---

---

Table of contents

• Features
• Architecture
• Installation
• Contributing
• License

Features

Web app

• Basic CRUD operations
• Localhost API for editing
• Responsive design for mobile and desktop
• Easy to use and customize
  • [ ] Widgets
  • [ ] Custom API
• Dynamic layout
• Theming

Backend

• Basic CRUD operations
• Secrets management
• Simple API
• Simple auth middleware

[!CAUTION] Simple auth should not be relied upon by itself

Architecture

• Frontend: Templ, TemplUI, TailwindCSS, and undecided [Datastar or Alpine.js]
• Backend: Go
• Database: Undecided [IndexedDB, SQLite]
• Storage: LocalStorage
• Cache: Service Worker
• CDN: Service Worker

Installation

Step 1: Clone the repository

Dependencies

The container way

• Podman / Docker

Containerfile

FROM tinygo/tinygo:0.37.0

WORKDIR /app

COPY . .

RUN tinygo build -o wasmdash.wasm main.go

CMD ["tinygo", "build", "-o", "wasmdash.wasm", "main.go"]

This will build the WebAssembly binary, you then need to extract it from the container.

Manually

podman pull tinygo/tinygo:0.37.0

Build and extract binary:

podman run --rm -v $(pwd):/app tinygo/tinygo:0.37.0 tinygo build -o wasmdash.wasm main.go

The binary way

• Go
• TinyGo

Screenshots

[!IMPORTANT] These will be updated regularly with new screenshots of the dashboard as it evolves.

08.06.2025

Frontpage	Dashboard

05.06.2025

03.06.2025

Contributing

Contributing

Dependencies

templ:

go install github.com/a-h/templ/cmd/templ@latest

tailwindcss

curl -sLO https://github.com/tailwindlabs/tailwindcss/releases/latest/download/tailwindcss-linux-x64
chmod +x tailwindcss-linux-x64
sudo mv tailwindcss-linux-x64 /usr/local/bin/tailwindcss

templui

go install github.com/axzilla/templui/cmd/templui@latest

air

go install github.com/air-verse/air@latest

start development server

make dev

License

MIT