I believe the Documentation is very vague and not helpful t all, is this all you need to do, not really right??
There are many useful JavaScript libraries that you might want to use in your target, especially to make it easier to build the simulator ( sim/simulator.js ). The basic pattern to do this is:
sim/public/js
sim/public/simulator.html using the <script> tagYeah the docs do tend to spin you in circles a bit - have faith the information is there - it’s just hard to take in all at once. I started from pxt-sample and worked my way slowly from there.
So yes, you do have a simulator which is your own sandboxed-iframe-land in which you can display whatever you want. This api is called a Board.
The blocks are executed (api.ts) and you make calls onto your board to do stuff. I haven’t done the electronics bit so my knowledge sortof ends there in terms of compiling for devices.
I found the best was to look at the labs and look at other pxts. You can tend to chart my progression by looking at https://github.com/Buildbee/makecode/commits/master
The other thing it took me a while to work out was that there are a lot of settings for your website stuffed into the pxtarget.json file, and it’s worthwhile sitting down and comparing the various targets to see and understand what to use.