Full‑Stack Developer Skill – Quick Guide

This page replaces the previous “Hello World” page on lab.simplyai.work. It shows how to use the @nanobot fullstack_dev skill to create, test, deploy, and PR new pages.

Command‑line cheat‑sheet

@nanobot fullstack_dev create project mykb static
@nanobot edit_file path=/Users/kevinhyt/Documents/Nanobot/workspace/projects/mykb/index.html old_text="<h1>Welcome</h1>" new_text="<h1>My Knowledge Base</h1>"
@nanobot fullstack_dev run tests mykb
@nanobot fullstack_dev deploy mykb kb-ui
@nanobot fullstack_dev open pr mykb kb-ui --merge
@nanobot fullstack_dev demo mykb

Option flags

Flag	Command	Description
`--merge`	`@nanobot fullstack_dev open pr mydemo kb-ui --merge`	After creating the PR, the bot will attempt to merge it automatically (requires write permission).
`--no‑tunnel`	`@nanobot fullstack_dev demo mydemo --no-tunnel`	Runs the local server only, without exposing a public URL.
`--verbose`	Append to any command	Shows raw `git`/`npm` output – helpful for debugging.

Step‑by‑step example workflow (create → test → deploy → PR)

Create a static page
```
@nanobot fullstack_dev create project mykb static
```
Bot reply: ✅ Created static project at /Users/kevinhyt/Documents/Nanobot/workspace/projects/mykb

Edit the page (you can edit manually or ask Nanobot). Example:

@nanobot edit_file path=/Users/kevinhyt/Documents/Nanobot/workspace/projects/mykb/index.html old_text="<h1>Welcome</h1>" new_text="<h1>My Knowledge Base</h1>"

Run any tests (static sites have none, but you can still run the command to confirm the script works):
```
@nanobot fullstack_dev run tests mykb
```
Bot reply: ⚠️ No recognizable test framework found.
Deploy to a preview branch (`kb-ui` is a good generic name):
```
@nanobot fullstack_dev deploy mykb kb-ui
```
Bot reply (after a few seconds): 🚀 Preview URL: https://kb-ui--lab.pages.dev/
Open a PR (so the change can be merged into main):
```
@nanobot fullstack_dev open pr mykb kb-ui
```
Bot reply: ✅ PR created: https://github.com/aryuu-allocfun/lab/pull/42
If you want it merged automatically (and you have write rights):
```
@nanobot fullstack_dev open pr mykb kb-ui --merge
```
(Optional) Run a live demo – useful if you added a Dockerfile or a Node dev server:
```
@nanobot fullstack_dev demo mykb
```
Bot reply: 🌐 Demo URL: https://a1b2c3d4.trycloudflare.com

How to edit files without leaving the chat

Nanobot already has a generic edit_file tool. Syntax:

@nanobot edit_file path=<full‑path> old_text="<exact‑old‑string>" new_text="<new‑string>"

Exact match required – make sure the old_text appears verbatim in the file.
For larger edits, surround the block with a unique comment marker (e.g., … ) and replace that block.

Common troubleshooting tips

Symptom	Likely cause	Fix
“Could not resolve host …” when checking a preview URL	The branch hasn’t been pushed yet, or the Cloudflare preview build is still in progress.	Wait a minute, then re‑run `@nanobot fullstack_dev deploy …` or simply re‑open the URL.
“Permission denied (publickey)” on git push	PAT file missing or unreadable, or git is still trying to use SSH.	Ensure `gh_token.txt` exists, contains the token, and the `deploy.sh` script uses the `https://[email protected]/...` URL (it does by default).
`gh` commands fail	`gh` not logged in.	Run once from the terminal: `gh auth login --with-token < ~/Documents/Nanobot/workspace/secrets/gh_token.txt`. After that the skill can call `gh` without interactive login.
`cloudflared` not found when running demo	CLI not installed or not in $PATH.	Install with `brew install cloudflared` and ensure `/usr/local/bin` (or the Homebrew bin) is on the PATH.

That’s it! Use the cheat‑sheet above to spin up new pages, test them, preview them instantly on Cloudflare Pages, and ship them via PRs—all without leaving Telegram. 🚀