LastLife/KUMOS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Compare commits

base: LastLife:main
Branches Tags
LastLife:main
LastLife:V1.0
..
compare: LastLife:V1.0
Branches Tags
LastLife:main
LastLife:V1.0

No commits in common. "main" and "V1.0" have entirely different histories.
main ... V1.0

1 changed files with 6 additions and 8 deletions
Show Stats Expand all files Collapse all files

14
README.md
View File

@ -4,8 +4,6 @@ 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)
@ -17,9 +15,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
@ -38,11 +36,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 http server 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 nginx 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.
@ -65,4 +63,4 @@ A minimal manifest:
## Status ## Status
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. Hobby project — fun, not production. Expect rough edges.