Troubleshooting

The preview never turns green

The dot beside the URL shows the dev server’s state. If it stays off:

1. Run npm install in the project — Stacki does this for a project it scaffolds, but not for one you cloned.
2. Run npm run dev in a terminal. If Astro will not start there, the fault is in the project’s config, not in Stacki, and the terminal will say so more plainly.
3. Check the port is free. Astro picks another if 4321 is taken, but a config pinning a port that something else holds will fail.

The page opened in a code editor

That is the fallback: the page contains markup the visual model does not represent. Nothing is wrong with the file, and nothing has been changed. See editing code.

A click on the canvas selects the wrong element

Clicks are resolved by hit-testing the cursor against the rendered boxes. An element covered by an absolutely positioned sibling — an overlay, a decorative layer — will hand the click to whatever is on top. Select it from the Navigator instead, which addresses the tree directly.

The canvas reloaded instead of patching

Some changes cannot be diffed into the page — a change to the layout that wraps it, or markup that cannot be lined up with what was there. Stacki falls back to a reload rather than applying a patch it is not sure of.

Styles are not going where I expect

Check the Add custom styles in control at the top of the style panel: that is the source being written to. Then check the breakpoint on the canvas — an edit at Tablet writes into the tablet query, not the base rule. See breakpoints.

Publish to GitHub does nothing

It shells out to the GitHub CLI. Install gh and run gh auth login once, then try again.

Something else

Open an issue at github.com/flowtricks/stacki/issues. Security issues should go to the maintainer privately rather than into a public issue.