Sign inSign up

hayone/craft-studio

By hayone

•Updated about 17 hours ago

VS Code in the browser with Claude Code and the craft apps, in one container

Image
0

373

hayone/craft-studio repository overview

⁠craft-studio

VS Code in the browser (code-server⁠) with Claude Code and the Craft Apps⁠ extension, plus the five storytold⁠ craft apps (PhotoCraft, VectorCraft, LightCraft, FilmCraft, EffectCraft) and the craft-mcp⁠ relay. All of it runs in one container on one port, so one-click hosts can run it.

Open the address, sign in with the password, and click an app in the Craft view. The app opens in an editor panel. Then ask Claude Code in the panel next to it, for example "open VectorCraft and draw a gold star".

docker run -d -p 8080:8080 -v craft-home:/home/coder -e PASSWORD=choose-one hayone/craft-studio
# open http://localhost:8080

⁠What runs inside

Path on the portWhat answers
/code-server, behind its password
/relay/the craft-mcp relay. The app pages and the coding agent meet here.
/healthzok, for the host's health check

The app pages are served inside the container only (127.0.0.1:4100/<app>/). The Craft Apps extension shows them through code-server's port proxy, so code-server's password protects them too.

⁠Settings

All settings are optional environment variables.

VariableWhat it does
PUBLIC_URLThe address people open, for example https://studio.example.com. Railway, Render, Koyeb and Fly.io are detected without it. The default is http://localhost:$PORT.
PASSWORDThe sign-in password. Without it, the first start makes one, saves it in /home/coder/.craft-studio/secrets.env and prints it in the log. HASHED_PASSWORD works too.
AUTHpassword (default) or none. Use none only behind another sign-in.
PORTThe port (default 8080).
PROJECT_DIRThe folder VS Code opens (default /home/coder/project).
CRAFT_APP_URLApp pages somewhere else, for example http://craft-app-{app}:8080/. Without it, the pages inside the container are used.
CRAFT_RELAY_URL, CRAFT_RELAY_TOKENA craft-mcp relay somewhere else, and one of its MINT_TOKENS. Without them, the relay inside the container is used.
RELAY_UPSTREAMWith an outside relay: its address inside your network, for example craft-mcp:8080. The container then passes PUBLIC_URL/relay/ on to it.
EMBED_ORIGINSEditors that may frame the inside app pages (default PUBLIC_URL,vscode-webview://*).
EXTENSIONSMore Open VSX extensions to install, separated by commas.
UPDATE_EXTENSIONSfalse keeps the installed Claude Code and Craft Apps versions. By default each start installs the newest ones.
CLAUDE_CLIfalse skips the claude command (the extension has its own copy).

Keep /home/coder on a volume. Your projects, settings, extensions and the generated secrets live there.

⁠Notes

  • Browsers only run VS Code's panels on https:// or on localhost. On a server, put the container behind HTTPS. One-click hosts do that for you.
  • Each person signs in to Claude Code in the Claude Code panel with their own account.
  • The app pages share the editor's address. Only the five app pages from the image are served there.

Source: hayone1/Docker_Images⁠. Deploy buttons, Docker Compose and a Helm chart: hayone1/craft-studio⁠.

Tag summary

Content type

Image

Digest

sha256:5bd6c872e…

Size

875.2 MB

Last updated

about 17 hours ago

docker pull hayone/craft-studio