xs-dev 0.25.1 → 0.25.3

package/README.md

@@ -8,7 +8,7 @@ The Moddable SDK and associated dev board tooling is incredibly empowering for e
 
 ## Requirements
 
-[Node.js >= v14](https://nodejs.org/en/)
+[Node.js >= v16](https://nodejs.org/en/)
 
 _If you've never installed Node.js before, check out the [getting started guide for xs-dev](https://hipsterbrown.github.io/xs-dev/en/guide/00-prepare#nodejs-package-manager-optional)._
 

package/build/commands/init.js

@@ -40,7 +40,7 @@ const command = {
                 if (selectedExample !== '' && selectedExample !== undefined) {
                     const selectedExamplePath = filesystem.resolve(exampleProjectPath, selectedExample);
                     info(`Generating project directory from ${selectedExample}`);
-                    filesystem.copy(selectedExamplePath, name);
+                    filesystem.copy(selectedExamplePath, name, { overwrite });
                 }
                 else {
                     warning('Please select an example template to use.');
@@ -79,4 +79,4 @@ const command = {
     },
 };
 exports.default = command;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5pdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb21tYW5kcy9pbml0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQ0EsdURBQWtFO0FBQ2xFLGlEQUEwRDtBQVUxRCxNQUFNLE9BQU8sR0FBbUI7SUFDOUIsSUFBSSxFQUFFLE1BQU07SUFDWixLQUFLLEVBQUUsQ0FBQyxHQUFHLENBQUM7SUFDWixXQUFXLEVBQUUsb0NBQW9DO0lBQ2pELEdBQUcsRUFBRSxLQUFLLEVBQUUsT0FBTyxFQUFFLEVBQUU7O1FBQ3JCLE1BQU0sRUFDSixVQUFVLEVBQ1YsVUFBVSxFQUNWLFFBQVEsRUFBRSxFQUFFLFFBQVEsRUFBRSxFQUN0QixLQUFLLEVBQUUsRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxFQUNqQyxNQUFNLEdBQ1AsR0FBRyxPQUFPLENBQUE7UUFFWCxNQUFNLElBQUksR0FBRyxVQUFVLENBQUMsS0FBSyxDQUFBO1FBQzdCLE1BQU0sRUFDSixVQUFVLEdBQUcsS0FBSyxFQUNsQixFQUFFLEdBQUcsS0FBSyxFQUNWLE9BQU8sR0FBRyxLQUFLLEVBQ2YsU0FBUyxHQUFHLEtBQUssRUFDakIsU0FBUyxHQUFHLEtBQUssR0FDbEIsR0FBZ0IsVUFBVSxDQUFDLE9BQU8sQ0FBQTtRQUVuQyxJQUFJLElBQUksS0FBSyxTQUFTLEVBQUU7WUFDdEIsSUFBSSxDQUFDLFNBQVMsSUFBSSxVQUFVLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxFQUFFO2dCQUM5QyxPQUFPLENBQ0wsb0JBQW9CLElBQUksbUZBQW1GLENBQzVHLENBQUE7Z0JBQ0QsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQTthQUNoQjtZQUVELE1BQU0sSUFBQSx3QkFBaUIsR0FBRSxDQUFBO1lBRXpCLElBQUksT0FBTyxLQUFLLEtBQUssRUFBRTtnQkFDckIsdUJBQXVCO2dCQUN2QixNQUFNLGtCQUFrQixHQUFHLFVBQVUsQ0FBQyxP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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5pdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb21tYW5kcy9pbml0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQ0EsdURBQWtFO0FBQ2xFLGlEQUEwRDtBQVUxRCxNQUFNLE9BQU8sR0FBbUI7SUFDOUIsSUFBSSxFQUFFLE1BQU07SUFDWixLQUFLLEVBQUUsQ0FBQyxHQUFHLENBQUM7SUFDWixXQUFXLEVBQUUsb0NBQW9DO0lBQ2pELEdBQUcsRUFBRSxLQUFLLEVBQUUsT0FBTyxFQUFFLEVBQUU7O1FBQ3JCLE1BQU0sRUFDSixVQUFVLEVBQ1YsVUFBVSxFQUNWLFFBQVEsRUFBRSxFQUFFLFFBQVEsRUFBRSxFQUN0QixLQUFLLEVBQUUsRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxFQUNqQyxNQUFNLEdBQ1AsR0FBRyxPQUFPLENBQUE7UUFFWCxNQUFNLElBQUksR0FBRyxVQUFVLENBQUMsS0FBSyxDQUFBO1FBQzdCLE1BQU0sRUFDSixVQUFVLEdBQUcsS0FBSyxFQUNsQixFQUFFLEdBQUcsS0FBSyxFQUNWLE9BQU8sR0FBRyxLQUFLLEVBQ2YsU0FBUyxHQUFHLEtBQUssRUFDakIsU0FBUyxHQUFHLEtBQUssR0FDbEIsR0FBZ0IsVUFBVSxDQUFDLE9BQU8sQ0FBQTtRQUVuQyxJQUFJLElBQUksS0FBSyxTQUFTLEVBQUU7WUFDdEIsSUFBSSxDQUFDLFNBQVMsSUFBSSxVQUFVLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxFQUFFO2dCQUM5QyxPQUFPLENBQ0wsb0JBQW9CLElBQUksbUZBQW1GLENBQzVHLENBQUE7Z0JBQ0QsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQTthQUNoQjtZQUVELE1BQU0sSUFBQSx3QkFBaUIsR0FBRSxDQUFBO1lBRXpCLElBQUksT0FBTyxLQUFLLEtBQUssRUFBRTtnQkFDckIsdUJBQXVCO2dCQUN2QixNQUFNLGtCQUFrQixHQUFHLFVBQVUsQ0FBQyxPQUFPLENBQzNDLE1BQU0sQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxFQUM1QixVQUFVLENBQ1gsQ0FBQTtnQkFDRCxNQUFNLFFBQVEsR0FBRyxNQUFBLFVBQVUsQ0FBQyxXQUFXLENBQUMsa0JBQWtCLENBQUMsMENBQUUsUUFBUSxDQUFBO2dCQUNyRSxNQUFNLE9BQU8sR0FDWCxRQUFRLEtBQUssU0FBUztvQkFDcEIsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLElBQUEsZ0NBQXNCLEVBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUU7b0JBQ25FLENBQUMsQ0FBQyxFQUFFLENBQUE7Z0JBQ1IsSUFBSSxlQUFlLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsTUFBTSxLQUFLLE9BQU8sQ0FBQyxDQUFBO2dCQUVsRSxJQUFJLE9BQU8sS0FBSyxJQUFJLElBQUksZUFBZSxLQUFLLFNBQVMsRUFBRTtvQkFDckQsTUFBTSxlQUFlLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQ2hELE1BQU0sQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQ2pDLENBQ0E7b0JBQUEsQ0FBQyxFQUFFLE9BQU8sRUFBRSxlQUFlLEVBQUUsR0FBRyxNQUFNLE1BQU0sQ0FBQyxHQUFHLENBQUM7d0JBQ2hEOzRCQUNFLElBQUksRUFBRSxjQUFjOzRCQUNwQixJQUFJLEVBQUUsU0FBUzs0QkFDZixPQUFPLEVBQUUsNENBQTRDOzRCQUNyRCxPQUFPLEVBQUUsZUFBZSxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLGVBQWUsQ0FBQyxDQUFDLENBQUMsT0FBTzt5QkFDaEU7cUJBQ0YsQ0FBQyxDQUFDLENBQUE7aUJBQ0o7Z0JBRUQsd0NBQXdDO2dCQUN4QyxJQUFJLGVBQWUsS0FBSyxFQUFFLElBQUksZUFBZSxLQUFLLFNBQVMsRUFBRTtvQkFDM0QsTUFBTSxtQkFBbUIsR0FBRyxVQUFVLENBQUMsT0FBTyxDQUM1QyxrQkFBa0IsRUFDbEIsZUFBZSxDQUNoQixDQUFBO29CQUNELElBQUksQ0FBQyxxQ0FBcUMsZUFBZSxFQUFFLENBQUMsQ0FBQTtvQkFDNUQsVUFBVSxDQUFDLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxJQUFJLEVBQUUsRUFBRSxTQUFTLEVBQUUsQ0FBQyxDQUFBO2lCQUMxRDtxQkFBTTtvQkFDTCxPQUFPLENBQUMsMkNBQTJDLENBQUMsQ0FBQTtvQkFDcEQsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQTtpQkFDaEI7YUFDRjtpQkFBTTtnQkFDTCxJQUFJLENBQUMsZ0NBQWdDLElBQUksRUFBRSxDQUFDLENBQUE7Z0JBRTVDLFVBQVUsQ0FBQyxHQUFHLENBQUMsSUFBSSxFQUFFLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxDQUFDLENBQUE7Z0JBRXRDLE1BQU0sUUFBUSxHQUFHO29CQUNmLEVBQUU7d0JBQ0EsQ0FBQyxDQUFDLHdDQUF3Qzt3QkFDMUMsQ0FBQyxDQUFDLDJDQUEyQztvQkFDL0MsVUFBVSxJQUFJLDhDQUE4QztpQkFDN0Q7cUJBQ0UsTUFBTSxDQUFDLE9BQU8sQ0FBQztxQkFDZixJQUFJLENBQUMsT0FBTyxDQUFDLENBQUE7Z0JBRWhCLE1BQU0sT0FBTyxHQUFXLFNBQVM7b0JBQy9CLENBQUMsQ0FBQyx5Q0FBeUM7b0JBQzNDLENBQUMsQ0FBQyxFQUFFLENBQUE7Z0JBRU4sTUFBTSxRQUFRLENBQUM7b0JBQ2IsUUFBUSxFQUFFLG1CQUFtQjtvQkFDN0IsTUFBTSxFQUFFLEdBQUcsSUFBSSxnQkFBZ0I7b0JBQy9CLEtBQUssRUFBRSxFQUFFLFFBQVEsRUFBRSxPQUFPLEVBQUU7aUJBQzdCLENBQUMsQ0FBQTtnQkFFRixNQUFNLFFBQVEsQ0FBQztvQkFDYixRQUFRLEVBQUUsYUFBYTtvQkFDdkIsTUFBTSxFQUFFLEdBQUcsSUFBSSxTQUFTLFVBQVUsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUU7aUJBQ25ELENBQUMsQ0FBQTthQUNIO1lBRUQsT0FBTyxDQUFDLDZCQUE2QixJQUFJLGdCQUFnQixDQUFDLENBQUE7U0FDM0Q7YUFBTTtZQUNMLE9BQU8sQ0FDTCxtRUFBbUUsQ0FDcEUsQ0FBQTtTQUNGO0lBQ0gsQ0FBQztDQUNGLENBQUE7QUFFRCxrQkFBZSxPQUFPLENBQUEifQ==

package/docs/astro.config.mjs

@@ -7,6 +7,5 @@ import solidJs from "@astrojs/solid-js";
 // https://astro.build/config
 export default defineConfig({
   integrations: [solidJs(), tailwind(), sitemap()],
-  site: 'https://hipsterbrown.github.io',
-  base: '/xs-dev',
+  site: 'https://xs-dev.js.org'
 })

package/docs/src/components/HeadCommon.astro

@@ -1,32 +1,38 @@
 ---
-import '../styles/theme.css';
-import '../styles/index.css';
+import '../styles/theme.css'
+import '../styles/index.css'
 ---
 
 <!-- Global Metadata -->
 <meta charset="utf-8" />
 <meta name="viewport" content="width=device-width" />
 
-<link rel="icon" type="image/svg+xml" href="/xs-dev/favicon.svg" />
-<link rel="alternate icon" type="image/x-icon" href="/xs-dev/favicon.ico" />
+<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+<link rel="alternate icon" type="image/x-icon" href="/favicon.ico" />
 
-<link rel="sitemap" href="/xs-dev/sitemap.xml" />
+<link rel="sitemap" href="/sitemap.xml" />
 
 <!-- Preload Fonts -->
 <link rel="preconnect" href="https://fonts.googleapis.com" />
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-<link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:ital@0;1&display=swap" rel="stylesheet" />
+<link
+  href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:ital@0;1&display=swap"
+  rel="stylesheet"
+/>
 
 <!-- Scrollable a11y code helper -->
-<script src="/xs-dev/make-scrollable-code-focusable.js" is:inline></script>
+<script src="/make-scrollable-code-focusable.js" is:inline></script>
 
 <!-- This is intentionally inlined to avoid FOUC -->
 <script is:inline>
-	const root = document.documentElement;
-	const theme = localStorage.getItem('theme');
-	if (theme === 'dark' || (!theme && window.matchMedia('(prefers-color-scheme: dark)').matches)) {
-		root.classList.add('theme-dark');
-	} else {
-		root.classList.remove('theme-dark');
-	}
+  const root = document.documentElement
+  const theme = localStorage.getItem('theme')
+  if (
+    theme === 'dark' ||
+    (!theme && window.matchMedia('(prefers-color-scheme: dark)').matches)
+  ) {
+    root.classList.add('theme-dark')
+  } else {
+    root.classList.remove('theme-dark')
+  }
 </script>

package/docs/src/components/Header/Search.tsx

@@ -16,7 +16,7 @@ const SearchForm: Component = () => {
   }
 
   onMount(async () => {
-    const content = await fetch('/xs-dev/search-index.json')
+    const content = await fetch('/search-index.json')
       .then((res) => res.json())
     const options = { keys: ['title', 'description', 'content'] }
     fuse = new Fuse(content, options)

package/docs/src/config.ts

@@ -43,5 +43,6 @@ export const SIDEBAR = {
     { text: 'Guide', header: true },
     { text: '00. Prepare', link: 'en/guide/00-prepare' },
     { text: '01. Hello Console', link: 'en/guide/01-hello-console' },
+    { text: '02. Guiding Light', link: 'en/guide/02-blinky' },
   ],
 }

package/docs/src/pages/en/guide/00-prepare.md

@@ -33,7 +33,7 @@ A local plain text editor is generally required for creating and editing your Ja
 
 These are not the only available editors, so feel free to do your own research and pick what feels right to you!
 
-## NodeJS Package Manager (optional)
+## NodeJS & Package Manager (optional)
 
 While [NodeJS](https://nodejs.org/en/) is not required for [Moddable XS](https://github.com/Moddable-OpenSource/moddable) projects, it is a dependency for installing and using the [`xs-dev` CLI](https://hipsterbrown.github.io/xs-dev/en/introduction/).
 
@@ -42,6 +42,7 @@ Node can be [downloaded directly from the website](https://nodejs.org/en/downloa
 - [Volta](https://volta.sh/)
 - [fnm](https://github.com/Schniz/fnm)
 - [asdf](https://asdf-vm.com/guide/getting-started.html#_4-install-a-plugin)
+- [rtx](https://github.com/jdxcode/rtx#installation)
 - [`pnpm env`](https://pnpm.io/cli/env)
 
 Node comes with [npm](https://docs.npmjs.com/cli/v8/commands/npm) as the included package manager, but there are other options available if needed:
@@ -62,3 +63,19 @@ Check out the [npm docs](https://docs.npmjs.com/resolving-eacces-permissions-err
 ## Linux Permissions
 
 Setup commands rely on [`ssh-askpass`](https://packages.ubuntu.com/bionic/ssh-askpass) to prompt for permission when installing other tools and dependencies.
+
+## Choose your hardware adventure
+
+Hardware is not required to get started with xs-dev, or even to run some code, since there are [simulated devices available with the Moddable SDK](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/tools/tools.md#simulator).
+
+Simulators are fun and everything, but controlling hardware with JavaScript is even better! `xs-dev` supports a few popular hardware platforms through [Moddable](https://github.com/Moddable-OpenSource/moddable):
+
+- [ESP8266](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/devices/esp8266.md)
+- [ESP32](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/devices/esp32.md)
+- [Raspberry Pi Pico](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/devices/pico.md)
+
+Each platform has a variety of features and form factors to support whatever you might dream up. This guide will do its best to provide code and diagrams that match the expectations of your chosen device(s) but cannot promise comprehensive coverage of every piece of hardware in existence.
+
+If you run into issues or have a question, please [start a discussion in the GitHub repo](https://github.com/HipsterBrown/xs-dev/discussions).
+
+Once you feel ready, [move on the first step of installing the CLI and the Moddable SDK](/en/guide/01-hello-console).

package/docs/src/pages/en/guide/01-hello-console.md

@@ -32,7 +32,7 @@ xs-dev setup
 
 This will determine the correct tooling to install based on your operating system.
 
-**[Windows support coming soon](https://github.com/HipsterBrown/xs-dev/pull/53)**
+**[Windows support is currently in beta](https://github.com/HipsterBrown/xs-dev/pull/63)**
 
 Once this process is done, you should see a success message:
 
@@ -40,9 +40,19 @@ Once this process is done, you should see a success message:
 Moddable SDK successfully set up! Start a new terminal session and run the "helloworld example": xs-dev run --example helloworld
 ```
 
+or on Windows, you should see the following:
+
+```
+Moddable SDK successfully set up!
+A shortcut to the Moddable Command Prompt has been created at \xs-dev\Moddable Command Prompt.lnk.
+You should always use the Moddable Command Prompt when working with the Moddable SDK.
+The Moddable Command Prompt will now open for you in a new Window. Please close this Command Prompt and use the Moddable Command Prompt instead.
+As a next step, try running the "helloworld example" in the Moddable Command Prompt: xs-dev run --example helloworld'
+```
+
 ## Run the Hello World example
 
-To start a new terminal session, you can either execute your shell of choice (`bash`/`zsh`/`fish`) or create a new terminal window / tab. This will ensure the expected tooling is available in your session [PATH](https://en.wikipedia.org/wiki/PATH_(variable)).
+To start a new terminal session, you can either execute your shell of choice (`bash`/`zsh`/`fish`), create a new terminal window / tab, or start the Moddable Command Prompt on Windows. This will ensure the expected tooling is available in your session [PATH](https://en.wikipedia.org/wiki/PATH_(variable)).
 
 You can [run any Moddable example included in the SDK](../features/run#moddable-examples). The "Hello World" example provides the simplest program to get started and can be run in the [simulator](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/tools/tools.md#simulator):
 
@@ -52,14 +62,16 @@ xs-dev run --example helloworld
 
 This will start up the debugger and simulator:
 
-![Moddable simulator app and debugger app running on MacOS](/xs-dev/run-hello-world.png)
+![Moddable simulator app and debugger app running on MacOS](/run-hello-world.png)
 
-This will keep running until the `Ctrl+C` keys are entered in the terminal session or both apps are quit.
+This will keep running until interrupted using the `Ctrl+C` keys in the terminal session or both apps are quit.
 
 ## Keep exploring!
 
 Use the `--list-examples` flag with the `run` command to search the extensive list of available examples to run in the simulator: `xs-dev run --list-examples`
 
+When you're ready to move on, it's time to [create your first project and control some hardware](/en/guide/02-blinky).
+
 ## Troubleshooting
 
 When attempting to run the Hello World example, if you continually see the following error (even after starting a new terminal session):
@@ -80,3 +92,18 @@ On "Unix-like" environments (MacOS, Linux), the `env` command should contain a r
 env | grep MODDABLE
 ```
 The above command should return something like `MODDABLE=/Users/<username>/.local/share/moddable` to indicate where the Moddable SDK has been installed in the filesystem.
+
+Running [`xs-dev doctor` command](/en/features/doctor) will display relevant info about the development environment, which can be helpful for debugging and sharing in support issues:
+
+```
+xs-dev environment info:
+  CLI Version                0.19.3
+  OS                         Darwin
+  Arch                       arm64
+  NodeJS Version             v16.14.0 (/path/to/node)
+  Python Version             3.10.9 (/path/to/python)
+  Moddable SDK Version       3.5.0 (/path/to/moddable)
+  Supported target devices   mac
+
+If this is related to an error when using the CLI, please create an issue at "https://github.com/hipsterbrown/xs-dev/issues/new" with the above info.
+```

package/docs/src/pages/en/guide/02-blinky.md

@@ -0,0 +1,175 @@
+---
+title: Guiding Light
+description: Initialize a new project and start to interact with some hardware!
+layout: ../../../layouts/MainLayout.astro
+---
+
+**Initialize a new project and start to interact with some hardware!**
+
+## Project creation
+
+The [`init` command](/en/features/init) will create a new directory with the name provided and saffold the starting files based on a template or example:
+
+```
+xs-dev init guiding-light
+```
+
+The above command should result in the following output:
+
+```
+Generating Moddable project: guiding-light
+Run the project using: cd guiding-light && xs-dev run
+```
+
+The `guiding-light` directory should contain `main.js` and `manifest.json` files. `main.js` contains that was run from the [Hello Console example](/en/guide/02-hello-console):
+
+```javascript
+debugger;
+
+let message = "Hello, world - sample";
+trace(message);
+```
+
+The first line is a [debugger statement](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/debugger) for setting a breakpoint in [xsbug](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/xs/xsbug.md).
+The third and fourth lines save a string to a variable and log it to the xsbug console using the global [`trace` function](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/xs/xsbug.md#colorizing-consolelog-with-trace).
+
+The [Moddable docs](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/tools/manifest.md) describe the `manifest.json` as follows:
+
+> A manifest is a JSON file that describes the modules and resources necessary to build a Moddable app.
+
+The initialized `manifest.json` in the `guiding-light` project should look like this:
+
+```json
+{
+  "include": [
+    "$(MODDABLE)/examples/manifest_base.json"
+  ],
+  "modules": {
+    "*": "./main"
+  }
+}
+```
+
+The [`include` field](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/tools/manifest.md#include) contains references to other manifests to provide quick reuse of common configuration found in the Moddable SDK, examples, and your own projects. The `manifest_base.json` includes basic platform support for all available platforms and some initial modules for time, timers, and instrumentation.
+
+The [`modules` field](https://github.com/Moddable-OpenSource/moddable/blob/public/documentation/tools/manifest.md#modules) should contain a mapping of every module to include in the build. The `*` key means the module (or list of modules) can be imported and referenced by their file name. A custom key can be used as an alias to reference when importing the assigned module.
+
+Executing `xs-dev run` should provide the same experience as the [Hello Console guide](/en/guide/01-hello-console).
+
+_Quick tip: check out all the available simulators by using the [`--list-devices` flag](/en/features/run#select-a-device-target) with the `run` command and typing "simulator" to filter the list._
+
+## Down to the metal
+
+At this point, we have our [chosen hardware in hand](/en/guide/00-prepare#choose-your-hardware-adventure) and need to set up the dev environment to start running code on the device. 
+
+Just like the [previous step](/en/guide/01-hello-console#setup-system-tooling), the `setup` command will automate the installation and building of tooling required for the target device. The `--list-devices` flag will provide an interactive list of supported device platforms:
+
+```
+❯ xs-dev setup --list-devices
+? Here are the available target devices: …
+esp8266
+esp32
+pico
+wasm
+mac
+```
+
+_You may see different options depending on what operating system or version of xs-dev you are using._
+
+Once this process is done, you should see a success message (where `<device>` is the selected target device):
+
+```
+Successfully set up <device> platform support for Moddable!
+Test out the setup by starting a new terminal session, plugging in your device, and running: xs-dev run --example helloworld --device=<device>
+If there is trouble finding the correct port, pass the "--port" flag to the above command with the path to the /dev.cu.* that matches your device.
+```
+
+Running our project on the selected device (which should be connected to the computer somehow, presumable over USB) is the same command as before with the additional `--device` flag to pass in the target device platform:
+
+```
+xs-dev run --device <device>
+```
+
+This will take some time to compile and send the code over to the device. When it has succeeded, the debugger will open like before but now it is tracing the logs coming from the hardware!
+
+👏 Give yourself a round of applause! You have now run JavaScript on an embedded device! 🎉
+
+## Hello blinky
+
+Now that we know we can run code on our device, it is time to shed a little light on hardware control. We will use the [ECMA-419 standard APIs](https://419.ecma-international.org/) to perform this task. To access those APIs we need to include them in our project:
+
+```
+xs-dev include io
+```
+
+The [`include` command](/en/features/include) updates the `manifest.json` to (you guessed it) _include_ the required module(s) from the Moddable SDK. In this case, the `io` module provides the complete set of ECMA-419 APIs for the supported device platform. The `manifest.json` should look like this:
+
+```json
+{
+  "include": [
+    "$(MODDABLE)/examples/manifest_base.json",
+    "$(MODDABLE)/modules/io/manifest.json"
+  ],
+  "modules": {
+    "*": "./main"
+  }
+}
+```
+
+With that configured, the `main.js` file can be updated with the following code:
+
+```javascript
+const Digital = device.io.Digital;
+const led = new Digital({
+   pin: device.pin.led,
+   mode: Digital.Output,
+});
+led.write(1);
+
+let state = 0;
+System.setInterval(() => {
+	led.write(state);
+	if (state === 0) {
+        state = 1;
+    } else {
+        state = 0;
+    }
+}, 200);
+```
+
+Using the [global `device` variable](https://419.ecma-international.org/#-16-host-provider-instance-global-variable) provided by the `io` module, we can access the [`Digital` IO class](https://419.ecma-international.org/#-10-io-classes-digital) for controlling the digital output to an LED. In this example, the `Digital` class is instantiated with the `pin` property set to the built-in led as [defined on the global `device`](https://419.ecma-international.org/#-16-host-provider-instance-pin-name-property) and the `mode` set to the [`Digital.Output`](https://419.ecma-international.org/#-10-io-classes-digital) static property found on the class. With that Digital instance variable called `led`, the [`write` method](https://419.ecma-international.org/#-9-io-class-pattern-write-method) is called with a value of `1` to send power to the LED.
+
+```javascript
+const Digital = device.io.Digital;
+const led = new Digital({
+   pin: device.pin.led,
+   mode: Digital.Output,
+});
+led.write(1);
+```
+
+To make the light blink, the next value to be written is stored as the `state` variable. The global [`System` class](https://github.com/Moddable-OpenSource/moddable/blob/public/modules/io/system/system.js) provides the well-known [`setInterval`](https://developer.mozilla.org/en-US/docs/Web/API/setInterval) function that is found in other JavaScript runtimes like the Web and Node.js. Every 200 milliseconds, the `state` is written to the LED before being updated to the opposite value.
+
+```javascript
+let state = 0;
+System.setInterval(() => {
+	led.write(state);
+	if (state === 0) {
+        state = 1;
+    } else {
+        state = 0;
+    }
+}, 200);
+```
+
+The project can be run using the same command as before: `xs-dev run --device <device>`. If it succeeds, you should see a blinking LED somewhere on your device! ✨
+
+## Keep exploring!
+
+Tried adding some `trace` calls to log the state to the debugger or updating the timer code to send a message in [Morse code](https://ledask.com/morse-code-lights/).
+
+_Coming soon: react to digital input by pressing some buttons_
+
+## Troubleshooting
+
+If you're working with a device that doesn't have an on-board LED or encounter an error while trying to use the `device.pin.led` value, the [pin specifier](https://419.ecma-international.org/#-9-io-class-pattern-pin-specifier) can be set to a custom value based on the device datasheet or pinout diagram, like [this one for the Pico](https://pico.pinout.xyz/). The pin value can match the on-board LED or [an external LED](https://www.sparkfun.com/products/12062) connected to a GPIO, most likely by using a [breadboard](https://learn.sparkfun.com/tutorials/how-to-use-a-breadboard#building-your-first-breadboard-circuit).

package/docs/src/pages/en/introduction.md

@@ -14,14 +14,14 @@ The Moddable SDK and associated dev board tooling is incredibly empowering for e
 
 **Features:**
 
-- [X] [Moddable SDK setup](/xs-dev/en/features/setup)
-- [X] [SDK updates](/xs-dev/en/features/update)
-- [X] [Teardown](/xs-dev/en/features/teardown)
-- [X] [Device discovery](/xs-dev/en/features/scan)
-- [X] [Project creation](/xs-dev/en/features/init)
-- [X] [Run a project or example](/xs-dev/en/features/run)
-- [X] [SDK module management](/xs-dev/en/features/include)
-- [X] [Get dev environment info](/xs-dev/en/features/doctor)
+- [X] [Moddable SDK setup](/en/features/setup)
+- [X] [SDK updates](/en/features/update)
+- [X] [Teardown](/en/features/teardown)
+- [X] [Device discovery](/en/features/scan)
+- [X] [Project creation](/en/features/init)
+- [X] [Run a project or example](/en/features/run)
+- [X] [SDK module management](/en/features/include)
+- [X] [Get dev environment info](/en/features/doctor)
 - [ ] Third-party dependency management ([coming soon](https://github.com/HipsterBrown/xs-dev/issues/49))
 
 **Platform support:**
@@ -34,9 +34,15 @@ The Moddable SDK and associated dev board tooling is incredibly empowering for e
 
 <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/1gxFWBnDl18" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 
+**Read through the starter guide for a detailed walkthrough**
+
+0. [Prepare for embedded JS development](/en/guide/00-prepare)
+1. [Hello Console](/en/guide/01-hello-console)
+2. [Guiding light](/en/guide/02-blinky)
+
 ## Requirements
 
-[Node.js >= v14](https://nodejs.org/en/)
+[Node.js >= v16](https://nodejs.org/en/)
 
 _If you've never installed Node.js before, check out the [getting started guide for xs-dev](/xs-dev/en/guide/00-prepare#nodejs-package-manager-optional)._
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xs-dev",
-  "version": "0.25.1",
+  "version": "0.25.3",
   "description": "CLI for automating the setup and usage of Moddable XS tools",
   "types": "build/types/types.d.ts",
   "bin": {
@@ -54,9 +54,9 @@
   },
   "devDependencies": {
     "@astrojs/mdx": "^0.16.2",
-    "@astrojs/sitemap": "^1.2.1",
-    "@astrojs/solid-js": "^2.1.0",
-    "@astrojs/tailwind": "^3.1.1",
+    "@astrojs/sitemap": "^1.3.1",
+    "@astrojs/solid-js": "^2.2.0",
+    "@astrojs/tailwind": "^3.1.3",
     "@babel/core": ">=7.20.12 <8.0.0",
     "@changesets/cli": "^2.19.0",
     "@release-it/conventional-changelog": "^5.1.1",
@@ -68,7 +68,7 @@
     "@typescript-eslint/eslint-plugin": "^4.33.0",
     "@typescript-eslint/parser": "^4.33.0",
     "@webcomponents/template-shadowroot": "^0.1.0",
-    "astro": "^2.1.5",
+    "astro": "^2.5.0",
     "eslint": "^7.32.0",
     "eslint-config-prettier": "^8.3.0",
     "eslint-config-standard-with-typescript": "^21.0.1",