Compare commits

...

2 Commits
V1.0 ... main

Author SHA1 Message Date
778fbadc5c Update README.md 2026-05-02 14:53:53 +00:00
f6f29ee161 Update README.md 2026-05-02 14:09:13 +00:00

View File

@ -4,6 +4,8 @@ A browser-based desktop operating system. Login, windows, taskbar, files, apps
Built as a learning project around an intentionally unconventional stack: a PureBasic / FastCGI / SQLite backend, with a SpiderBasic frontend that compiles to plain JavaScript and HTML5. Built as a learning project around an intentionally unconventional stack: a PureBasic / FastCGI / SQLite backend, with a SpiderBasic frontend that compiles to plain JavaScript and HTML5.
![Demo](https://lastlife.net/ForumUpload/KumoDemo.gif)
## Features ## Features
- Multi-user authentication (salted SHA-256, session cookies) - Multi-user authentication (salted SHA-256, session cookies)
@ -15,9 +17,9 @@ Built as a learning project around an intentionally unconventional stack: a Pure
## Stack ## Stack
- **Server** PureBasic 6.30, FastCGI, SQLite - **Server** - PureBasic 6.30, FastCGI, SQLite
- **Client** SpiderBasic 3.20 (compiles to JS/HTML5) - **Client** - SpiderBasic 3.20 (compiles to JS/HTML5)
- **Dev environment** Podman + nginx, or the built-in `WebServer.pbi` for debug builds - **Dev environment** - Podman + nginx, or the built-in `WebServer.pbi` for debug builds
## Layout ## Layout
@ -36,11 +38,11 @@ Client/
## Building ## Building
**Server.** Open `Server/KUMOS Server.pbp` in PureBasic, build and run. The first launch creates `kumos.db`, the `blobs/` and `apps/` directories, and a default `admin / admin` account change the password immediately. The FastCGI listener defaults to port 9683. **Server.** Open `Server/KUMOS Server.pbp` in PureBasic, build and run. The first launch creates `kumos.db`, the `blobs/` and `apps/` directories, and a default `admin / admin` account; change the password immediately. The FastCGI listener defaults to port 9683.
**Client.** Open `Client/KUMOS.sbp` in SpiderBasic and build. Output goes to `Server/www/`. **Client.** Open `Client/KUMOS.sbp` in SpiderBasic and build. Output goes to `Server/www/`.
**Debug.** A debug build of the server also starts an HTTP server on port 8080 that proxies `/api/*` to FastCGI and serves `www/` directly — no nginx needed. Visit `http://localhost:8080/`. **Debug.** A debug build of the server also starts an HTTP server on port 8080 that proxies `/api/*` to FastCGI and serves `www/` directly; no http server needed. Visit `http://localhost:8080/`.
**Production.** Run nginx (or any web server) in front, serving `www/` statically and forwarding `/api/*` to `127.0.0.1:9683` over FastCGI. **Production.** Run nginx (or any web server) in front, serving `www/` statically and forwarding `/api/*` to `127.0.0.1:9683` over FastCGI.
@ -63,4 +65,4 @@ A minimal manifest:
## Status ## Status
Hobby project — fun, not production. Expect rough edges. It goes without saying that this is a joke project (despite the crazy efforts I put in). I won't fix anything, I won't add any feature, it's already very close to imploding as it is.