| name | ruckus-core |
| description | Use when working with the Racket backend, adding or modifying RPC methods,
or understanding the Racket-Swift communication layer. Covers define-rpc,
Backend.swift codegen, and the Noise RPC framework.
|
| user-invocable | false |
Ruckus Core (Racket Backend)
Racket handles business logic; Swift/SwiftUI provides the iOS UI layer.
They communicate via the Noise RPC framework.
RPC methods are defined in ruckus-core/main.rkt using define-rpc.
The Makefile runs noise-serde-codegen to auto-generate
Ruckus/Backend.swift with corresponding async Swift methods. Do not
edit Backend.swift manually — it is regenerated from Racket source.
Flow: ruckus-core/*.rkt → make → Backend.swift
(auto-generated) + res/core.zo (bytecode)
Adding an RPC Method
- Add
(define-rpc (name : ReturnType) body) in ruckus-core/main.rkt
- Run
make to regenerate Backend.swift and recompile bytecode
- Call
Backend.shared.name() from Swift
Naming Conventions
- Racket module names should be singular (e.g.
example.rkt, not examples.rkt).
Key Files
ruckus-core/main.rkt — Racket backend: RPC definitions and server entry point
