StillMade AIDeveloper docs
Browse documentation · SDK 0.1.0

Preview with hot reload

Preview a Block's interface locally in StillMade's own view host, with stand-ins for hosted calls, a console and reload on save.

stillmade-block dev <folder> opens a local preview at http://127.0.0.1:4800 (--port changes it). The page is StillMade's own view host: the same sandbox page, bridge, response policy, theme, run limits and guard that run your interface in the app, so what works here works there.

Edit the input as JSON beside it, pick another fixture, switch Light, Dark and White, and try phone, tablet and full widths.

operations, files, network, connections and storage are answered by stand-ins, and stand-in media (images, audio, video) previews in the view. Shared view state (updateShared) is kept in the page.

shared state. With --build "npm run build", saving any other source file (such as src/view.jsx) runs the build first, then reloads.

stand-in that answered, reloads, build output and errors from the view.

sites, and never contacts StillMade or a provider. Paid runs, sign-ins and keys happen only in StillMade, after you import the Block.

stillmade-block dev <folder> --live also prints a link to StillMade's Import page. Open it while signed in and choose Connect: each time you save, the packed Block (what pack would write) opens in StillMade's usual import review with its checks and preview, and confirming installs that version in your account, as a new revision of the same build. Use it in a project to run it with real hosted operations, files and connections; every paid step shows its price and asks first, as for any Block.

which changes each time dev starts. --site sets another StillMade address (https). Stop the link with Disconnect or by stopping dev.

Templates

stillmade-block create <folder> <template> writes a complete folder that validates and tests offline:

TemplateWhat it starts
recipe (default), image, statefulBuilt-in steps with no code; memory between runs
javascriptA few lines of sandboxed JavaScript
module, module-wasmModern JavaScript modules in a Worker, with WebAssembly
module-hostedA module calling hosted text and image generation as tools
view-react, view-htmlA frame view in React (bundled with esbuild) or plain web code
text, image-generate, video-generate, speech, music, sfx, transcribe, describe-image, analyze-media, web-fetch, web-research, timeline-proposalOne hosted operation each, on the person's credits
outside-api, connectionAn outside API with the person's own key; a published adapter with their sign-in
storageValues kept across runs in project storage
trigger-media, trigger-webhook, trigger-scheduleBlocks that run on their own once the project owner turns them on