A Blocks / JavaScript code editor for the micro:bit built on Microsoft MakeCode
CSS TypeScript C++ C# Objective-C HTML Other
Clone or download
Latest commit c789e29 Jul 9, 2018
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue template for microbit May 17, 2018
.vscode fixing getting started Apr 29, 2017
clients Chromeextension (#499) Aug 8, 2017
docfiles Add css files under docfiles Aug 15, 2017
docs add calibration info (#897) Jun 26, 2018
editor WebUSB support (#632) Mar 21, 2018
electron Release Electron app v0.9.15 Mar 7, 2017
external Support for HID-based partial super-fast flashing (#523) Sep 18, 2017
libs Merge branch 'master' of https://github.com/Microsoft/pxt-microbit Jun 6, 2018
pxtwapp super basic trouble shooting page for windows app (#585) Dec 5, 2017
sim support for servos on more pins in simulator Jun 9, 2018
tests surfacing missing repeat parameter (#380) Apr 3, 2017
theme Serial (#554) Oct 20, 2017
.gitattributes Add own manifest Apr 9, 2016
.gitignore updated language list Mar 12, 2018
.travis.yml updated pxt and moving to node 8 (#631) Feb 6, 2018
CONTRIBUTING.md Updating with the MIT license text and contributing guideline Nov 29, 2016
LICENSE.txt Updating with the MIT license text and contributing guideline Nov 29, 2016
README.md Update README.md Jun 16, 2018
THIRD-PARTY-NOTICES.txt add attribution Jan 31, 2017
faviconDescription.json adding favicon configuration file Oct 20, 2016
package-lock.json 0.14.43 Jul 9, 2018
package.json 0.14.43 Jul 9, 2018
ptrcheck-ignore update ignore file Jul 14, 2016
pxtarget.json adding slovak to pxtarget Jun 20, 2018
targetconfig.json adding slovak Jun 20, 2018
travis-tests.sh Remove 3 converter tests with overflowing numbers Oct 4, 2016
tslint.json fixing various lint violations May 5, 2016
webmanifest.json Updating all pxt.microbit.org reference to makecode.microbit.org (#460) Jul 24, 2017

README.md

micro:bit target for PXT

This target allows you to program a BBC micro:bit using PXT (Microsoft Programming Experience Toolkit).

Build Status

Issue tracking

Please add an issue if you discover an (unreported) bug.

Local server

The local server lets you to run the editor and serve the documentation from your own computer.

Setup

This section explains how to setup your development environment for pxt-microbit, whether that be to run a copy locally or to make source changes.
Note that pxt-microbit can not be run without its main dependancy, pxt. Below explains how to setup both.

The following commands perform a one-time setup after synching the repo on your machine.

  • Note for any editing of the .cpp files, Yotta must be installed. To do so, follow the instructions on their site.
  • Install node.js 8.9.4 or higher.
  • Install requirements for pxt. Note the v0 branch must be used for pxt-microbit (add sudo for Mac/Linux shells).
npm install -g jake
npm install -g typings
git clone https://github.com/microsoft/pxt
cd pxt
git checkout v0
  • Install the pxt dependencies.
npm install
typings install
jake
cd ../
git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
  • install the PXT command line (add sudo for Mac/Linux shells).
npm install -g pxt
  • install the dependencies
npm install

  • Link pxt-microbit back to base pxt repo.
npm link ../pxt

Note the above command assumes the folder structure of

       makecode
          |
  -----------------
  |               |
 pxt        pxt-microbit

Running

Run this command from inside pxt-microbit to open a local web server (add sudo for Mac/Linux shells)

pxt serve --cloud

If the local server opens in the wrong browser, make sure to copy the URL containing the local token. Otherwise, the editor will not be able to load the projects.

If you need modify the .cpp files (and have installed yotta), enable yotta compilation by removing the --cloud flag (add sudo for Mac/Linux shells):

pxt serve

Updates

To update your PXT version and make sure you're running the latest tools, run (add sudo for Mac/Linux shells):

pxt update

More instructions are at https://github.com/Microsoft/pxt#running-a-target-from-localhost

Repos

The pxt-microbit target depends on several other repos. The main ones are:

History

See the MakeCode blog.

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.