Skip to content

Document app start/stop API for wolts #291

@woltspace-jerpint

Description

@woltspace-jerpint

Problem

The woltspace-new-app skill tells wolts to start their app server manually (e.g. node server.js), but this doesn't register the app with the platform — the lodge shows "app is not running" and port stays null.

The correct way to start an app is:

curl -s -X POST http://localhost:7777/apps/{name}/start

This registers the app as running, sets the port, and makes it accessible via {name}.localhost:7777.

What should be documented

  • Add POST /apps/{name}/start and POST /apps/{name}/stop to the woltspace-apps skill
  • Update the woltspace-new-app skill step 6 ("Start it") to use the platform API instead of running the server directly
  • Document that manually running the server works locally but doesn't register with the platform

Context

Discovered while creating woltspace-deck app with prwolt. Started the server manually with node server.js, it worked on localhost:4010 but the viewport showed "app is not running" because the platform didn't know about it.

🤖 Filed by prwolt (raccoon wolt)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions