# @webqit/webflo

> The universal, fullstack JavaScript framework.

Latest version **0.20.62** (published 2026-02-18) · MIT license · 0 weekly downloads

## Install

```sh
npm install @webqit/webflo
pnpm add @webqit/webflo
yarn add @webqit/webflo
bun add @webqit/webflo
```

Provides the commands `webflo`, `webflo-certbot-http-auth-hook`, `webflo-certbot-http-cleanup-hook`.

## Health

**Score 50/100 (C)** — status: stable.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.20.62 |
| Published | 2026-02-18 |
| First published | 2020-12-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 19 |
| Unpacked size | 7.3 MB |
| Known vulnerabilities | 0 (+8 in 3 direct dependencies) |
| Install scripts | no |
| GitHub stars | 33 |
| Author | Oxford Harrison |
| Maintainers | ox-harris |
| Keywords | git-workflow, self-hosting, automatic-deployment, command-line-interface, progressive-web-apps, single-page-apps, vanila-javascript |

## Links

- npm: https://www.npmjs.com/package/@webqit/webflo
- Repository: https://github.com/webqit/webflo
- Homepage: https://webqit.io/tooling/webflo
- Issues: https://github.com/webqit/webflo/issues
- npm.io page: https://npm.io/package/@webqit/webflo

## Dependencies (19)

- [idb](https://npm.io/package/idb.md) ^8.0.3
- [dotenv](https://npm.io/package/dotenv.md) ^16.4.7
- [esbuild](https://npm.io/package/esbuild.md) ^0.27.3
- [chokidar](https://npm.io/package/chokidar.md) ^4.0.3
- [fast-glob](https://npm.io/package/fast-glob.md) ^3.3.3
- [mime-types](https://npm.io/package/mime-types.md) ^2.1.33
- [simple-git](https://npm.io/package/simple-git.md) ^2.20.1
- [cross-spawn](https://npm.io/package/cross-spawn.md) ^7.0.6
- [@webqit/util](https://npm.io/package/@webqit/util.md) ^0.8.11
- [@webqit/keyval](https://npm.io/package/@webqit/keyval.md) ^0.2.17
- [@webqit/backpack](https://npm.io/package/@webqit/backpack.md) ^0.1.12
- [@webqit/observer](https://npm.io/package/@webqit/observer.md) ^3.8.14
- [@webqit/url-plus](https://npm.io/package/@webqit/url-plus.md) ^0.1.8
- [@webqit/use-live](https://npm.io/package/@webqit/use-live.md) ^0.5.49
- [@octokit/webhooks](https://npm.io/package/@octokit/webhooks.md) ^7.15.1
- [@webqit/port-plus](https://npm.io/package/@webqit/port-plus.md) ^0.1.22
- [@webqit/fetch-plus](https://npm.io/package/@webqit/fetch-plus.md) ^0.1.31
- [@webqit/oohtml-ssr](https://npm.io/package/@webqit/oohtml-ssr.md) ^2.2.4
- [urlpattern-polyfill](https://npm.io/package/urlpattern-polyfill.md) ^4.0.3

## Recent versions

- 0.20.62 (latest) — 2026-02-18
- 0.20.13-next.1 (next) — 2025-12-03
- 0.20.61 — 2026-02-17
- 0.20.60 — 2026-02-17
- 0.20.59 — 2026-02-17
- 0.20.58 — 2026-02-17
- 0.20.57 — 2026-02-17
- 0.20.56 — 2026-02-11
- 0.20.55 — 2026-02-08
- 0.20.54 — 2026-02-08
- 0.20.53 — 2026-02-07
- 0.20.52 — 2026-02-06
- 0.20.51 — 2026-02-06
- 0.20.50 — 2026-02-06
- 0.20.49 — 2026-02-06
- … 388 more at https://npm.io/package/@webqit/webflo/versions

## README

# Webflo – _A next-gen, web-native framework_

[![npm version][npm-version-src]][npm-version-href]<!--[![npm downloads][npm-downloads-src]][npm-downloads-href]-->
[![License][license-src]][license-href]

_Build the full spectrum of modern applications — backends, frontends, offline-first, and realtime apps — on raw platform power._ 🛸<br>
[Webflo ↗](https://webflo.netlify.app/overview) is a web-native framework that lets you build absurdlly fast — with the whole sophistication and scale of modern apps solved from the foundation up.

---

> [!IMPORTANT]
> 🚀 **Webflo is in active development and evolving daily.** Current status = **alpha**.<br>
> You’re welcome to experiment, but it’s not yet suited for production apps.

---

## Getting Started

For a quick intro, see the docs:

+ [Getting Started ↗](https://webflo.netlify.app/docs/getting-started)
+ [Core Concepts ↗](https://webflo.netlify.app/docs/concepts)
+ [Examples ↗](https://webflo.netlify.app/examples)

---

## What You Can Build

| Category                   | Examples & Notes                                                                                                 |
| :------------------------- | :--------------------------------------------------------------------------------------------------------------- |
| **Web apps**               | Anything from classic MPAs to rich SPAs – with SSR/CSR/hybrid rendering patterns.                                |
| **API backends**           | REST endpoints and webhooks – with streaming, partial responses, and live messaging.                             |
| **Static sites**           | Static-first or fully pre-rendered sites – with the same client-side richness of a Webflo app.                    |
| **Mobile experiences**     | Installable, offline-capable PWAs – with background sync, push notifications, and more.                           |
| **Realtime & multiplayer** | Chats, presence, dashboards, live docs, notifications – realtime channels and dialogs available out of the box.   |
| **AI & agents**            | Multi-step AI workflows, background agents, and automation – powered by Webflo’s realtime capabilities.           |

---

## Features

| Feature                               | Description                                                                                         |
| :------------------------------------ | :-------------------------------------------------------------------------------------------------- |
| 📁 **Folder-based routing**           | Filesystem routing across client, service worker, and server layers.                                 |
| 🌍 **Service Worker routing**         | Support for route handlers in the service worker.                                                   |
| 🔐 **Sessions & auth**                | Built-in cookie handling, session utilities, and helpers for gated routes and user-aware flows.     |
| ⚡ **Realtime capabilities**           | Live responses, mutable/differential responses, two-way background messaging — all built in.       |
| 🧠 **Mutation-based reactivity**       | State is plain objects and arrays; mutations drive reactivity via the Observer API.                 |
| 🧱 **OOHTML integration**              | HTML-native templates, imports, and composition without a component DSL or build-heavy toolchain.   |
| 🧩 **Dev mode & HMR**                 | Fast development server with fine-grained rebuilds and hot updates for HTML, JS, and CSS.           |

---

## Contributing

Webflo is in active development — and contributions are welcome!  

Here’s how you can jump in:  
- **Issues** → Spot a bug or have a feature idea? Open an [issue](https://github.com/webqit/webflo/issues).  
- **Pull requests** → PRs are welcome for fixes, docs, or new ideas.  
- **Discussions** → Not sure where your idea fits? Start a [discussion](https://github.com/webqit/webflo/discussions).  

### 🛠️ Local Setup

⤷ clone → install → test

```bash
git clone https://github.com/webqit/webflo.git
cd webflo
git checkout next
npm install
npm test
```

### 📝 Tips

- Development happens on the `next` branch — be sure to switch to it as above after cloning.
- Consider creating your feature branch from `next` before making changes (e.g. `git checkout -b feature/my-idea`).
- Remember to `npm test` before submitting a PR.

## 🔑 License

MIT — see [LICENSE](https://github.com/webqit/webflo/blob/master/LICENSE)

[npm-version-src]: https://img.shields.io/npm/v/@webqit/webflo?style=flat&colorA=18181B&colorB=F0DB4F
[npm-version-href]: https://npmjs.com/package/@webqit/webflo
[npm-downloads-src]: https://img.shields.io/npm/dm/@webqit/webflo?style=flat&colorA=18181B&colorB=F0DB4F
[npm-downloads-href]: https://npmjs.com/package/@webqit/webflo
[license-src]: https://img.shields.io/github/license/webqit/webflo.svg?style=flat&colorA=18181B&colorB=F0DB4F
[license-href]: https://github.com/webqit/webflo/blob/master/LICENSE

---
_Source: https://npm.io/package/@webqit/webflo · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
