MakeCode for Adafruit Circuit Playground Express 

This repo contains the editor hosted at https://makecode.adafruit.com .

* (optional) install Visual Studio Code

Local server setup

This setup gives you a local version of the editor and the ability to load packages from your machine. This is the setup to develop new packages.

$3

* install Node.js 8+
* clone https://github.com/Microsoft/pxt-adafruit to `pxt-adafruit folder
* go to pxt-adafruit and run

`
npm install
`

Don't forget to periodically git pull and npm install to get the latest changes.

$3

This command launches a local web server. Note that this web server is meant for development purposes only. It was not designed or secured to be run on a web server.

`
npm run serve
`

$3

* go to /projects under the pxt-adafruit folder
* clone your package repo, say pxt-helloworld
* launch the server with npm run serve from the pxt-adafruit folder using npm serve
* create a new project
* go to project settings and click on Edit settings as text
* add an entry in the dependency section that points to your project
`
"dependencies": {
"circuit-playground": "*",
"helloworld": "file:../pxt-helloworld"
},
`
* click on the Blocks icon to reload the blocks.

Once this project is setup, simply reload the editor after making changes on disk.

Local Dev setup

This setup is needed if you plan to make changes in PXT itself. In most cases, it's a bit of an overkill
if you are building a package for the Adafruit editor.

* install Node.js 8+
* install the PXT command line
`
npm install -g pxt
`

In a common folder,

* clone https://github.com/Microsoft/pxt to pxt folder
* clone https://github.com/Microsoft/pxt-common-packages to pxt-common-packages folder
* clone https://github.com/Microsoft/pxt-adafruit to pxt-adafruit folder
* go to pxt and run

`
npm install
npm run build
`

* go to pxt-common-packages and run

`
npm install
npm link ../pxt
`

* go to pxt-adafruit and run

`
npm install
npm link ../pxt
npm link ../pxt-common-packages
`

$3

From root github folder,

`
cd pxt-adafruit
pxt serve
`

$3

`
cd libs/core
pxt deploy
``

License

MIT

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Trademarks

MICROSOFT, the Microsoft Logo, and MAKECODE are registered trademarks of Microsoft Corporation. They can only be used for the purposes described in and in accordance with Microsoft’s Trademark and Brand guidelines published at https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. If the use is not covered in Microsoft’s published guidelines or you are not sure, please consult your legal counsel or MakeCode team (makecode@microsoft.com).