BoneShield

Express-like Python backend for beginners — MongoDB, JWT, WebSockets, nested file routing.

Default port: 313.

Install

pip install boneshield

Create a project

mkdir my-api
cd my-api
boneshield make
python main.py

Or: boneshield run

Beginner style (no imports)

main.py starts with one wiring line, then you use builtins directly:

import boneshield.bootstrap  # framework wiring — you can ignore this line

db = connect_mongo()

use("/api", "routes/api.py")

@get("/health")
def health(req):
    return makeResponse(200, data={"ok": True})

app.run()

Nest routes up to 5 layers with use("/prefix", "file.py").
Attach controllers like Node: get("/", usersController.list).

See GUIDE.md (routing, @useable, variables) and MONGO.md (database).

Autocomplete in Cursor / VS Code

boneshield make creates:

• typings/__builtins__.pyi (Pylance treats these as builtins — no import needed)
• .vscode/settings.json + boneshield.code-snippets
• pyrightconfig.json

Then reload the window once so suggestions for makeResponse, get, use, … show up while typing.

Commands

boneshield make          # scaffold project
boneshield make --force  # overwrite scaffold files
boneshield run           # run main.py with the loader
boneshield --help
boneshield --version