In praise of the single-file app
The single self-contained HTML file is the most underrated unit of software right now. Here's why the humble one-file app is suddenly everywhere, and why that's a good thing.
Somewhere along the way, software got heavy. A “simple app” grew to mean a repo, a package manager, a build step, a framework, a folder tree you scroll to read. We accepted that as the cost of doing things properly. And then AI quietly brought back something we’d half-forgotten: the single-file app. One HTML file. Everything in it. Double-click and it runs. It deserves more credit than it gets.
What a single-file app is
It’s exactly what it sounds like: a complete little application living in one .html file (markup, styles, and a bit of script), all self-contained. No build, no dependencies to install, no server required to open it. A chore chart. A unit converter. A pomodoro timer. A form that tallies responses. A dashboard that reads a few numbers and draws them.
For years this was seen as the toy end of software: fine for a demo, not “real.” That snobbery is worth letting go of, because the single-file app turns out to be the right size for an enormous number of genuine needs.
Why it’s suddenly everywhere
Two things changed.
First, AI made building one nearly free. You describe what you want and a working single-file app comes back in the time it takes to read this paragraph. The thing that used to gate small apps, the hours of fiddly coding, is gone. So people are making them constantly, often without thinking of themselves as “building software” at all.
Second, the browser quietly became an excellent runtime. A single HTML file can do a startling amount: store data locally, draw charts, handle interactions, look good on a phone. The gap between “one file” and “useful app” narrowed to almost nothing.
Put those together and you get abundance: lots of small, specific, personal apps, made by people who’d never have shipped software before.
The case for the form factor
The single-file app isn’t just convenient; the constraints are a feature.
- It’s legible. You can read the whole thing. There’s no hidden machinery, no dependency you didn’t choose, no build output you can’t inspect. What you see is what runs.
- It’s durable. No dependencies means nothing to rot. A single HTML file works the same next year. Compare that to a framework project that breaks if you look away for six months.
- It’s portable. It’s just a file. Email it, host it, open it offline. It doesn’t assume a particular platform or toolchain.
- It’s honest about scope. The form factor gently keeps the app small and focused. That’s usually the right instinct: most useful tools are small.
Constraints like these are what make a medium good. The sonnet, the index card, the single-file app: the limits are why they work.
The one thing it can’t do alone
There’s exactly one place the single-file app falls down, and it’s in the sharing, not the building. A file runs for one person on one machine. The moment you want other people to use it, you need three things a lone file can’t provide: an address, a way to control who’s allowed in, and somewhere to keep the data. That’s not a flaw in the form factor; it’s just the part that was always going to need a server.
This is the gap Backlit exists to fill. It takes a single-file app exactly as it is (no build, no rewrite) and gives it a live link, sign-in, and per-user storage. The file stays a file; it just gains the few powers it needed to be shared. And nothing runs inside it but your own code, which is what keeps it fast, cheap, and predictable.
A small manifesto
We don’t need every app to be a project. Most of the software that would genuinely improve a day is small: the tracker for one team, the form for one event, the planner for one household. The single-file app is the natural shape for that software, and AI just made it abundant.
The only thing missing was a dignified way to share it. Give the humble one-file app a real home and it stops being a toy and starts being the most practical kind of software there is. See how it works →
Built an app with Claude or ChatGPT? Get early access to Backlit and share it in seconds.