https://github.com/microsoft/pxt-sample
Sample target for PXT
https://github.com/microsoft/pxt-sample
makecode pxt
Last synced: 9 months ago
JSON representation
Sample target for PXT
- Host: GitHub
- URL: https://github.com/microsoft/pxt-sample
- Owner: microsoft
- License: mit
- Created: 2016-03-14T21:35:49.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-03-18T09:57:59.000Z (almost 3 years ago)
- Last Synced: 2025-03-30T09:08:12.141Z (9 months ago)
- Topics: makecode, pxt
- Language: TypeScript
- Homepage: https://microsoft.github.io/pxt-sample/
- Size: 28.2 MB
- Stars: 87
- Watchers: 22
- Forks: 151
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Sample target for a Microsoft MakeCode Editor
This repo contains a sample editor built with [Microsoft MakeCode (PXT)](https://github.com/Microsoft/pxt). The editor is hosted on the GitHub pages at [http://microsoft.github.io/pxt-sample/](http://microsoft.github.io/pxt-sample/)
[](https://travis-ci.org/Microsoft/pxt-sample)
[](https://aka.ms/makecodecommunity)
If you'd like to start your own editor, fork this repo and fix all the TODOs.
## TODOs
- [ ] Fork repo and setup local server (see below)
- [ ] Update metadata in ``pxtarget.json``. Change the id, title, name, etc... to your taste.
- [ ] Update the JavaScript runtime in ``sim/simulator.ts``. If needed add additional JS library under ``sim/public/**``
and edit ``sim/public/simulator.html`` with additional ``script`` tags.
- [ ] Update the APIs in ``sim/api.ts`` to use your runtime.
- [ ] Test your editor in the local server
- [ ] run ``pgk staticpkg --gh --bump`` to upload a static version to GitHub pages.
## Running locally
These instructions allow to run locally to modify the sample.
### Setup
The following commands are a 1-time setup after synching the repo on your machine.
* install [node.js](https://nodejs.org/en/)
* install the PXT command line
```
npm install -g pxt
```
* install the dependencies
```
npm install
```
### Running the local server
After you're done, simple run this command to open a local web server:
```
pxt serve
```
After making a change in the source, refresh the page in the browser.
## Updating the tools
If you would like to pick up the latest PXT build, simply run
```
pxt update
```
More instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost