Working fork of Touch Develop. Hosted at https://timgott.github.io/TouchDevelopApp/

Touch Develop - Offline Fork

Touch Develop is a touch-friendly, cross-platform, mobile-first app creation environment developed by Microsoft Research.

The servers have been shut down, so the original TouchDevelop is no longer accessible. This fork has some small fixes such that you can still use it, just without cloud publishing.

I believe that the unusual editor is still interesting to play with, since not many similar mobile focused development environments exist.

Since most of the libraries were distributed using the cloud service, some libraries will fail to load. Luckily, I could recover some of them from old cache files (script.cache, help.cache), so the most of the templates should work. The cache files also contain tutorials, demos and help files, but they are not accessible from the UI at the moment.

Writing and saving Touch Develop scripts

This repo contains the source code of the Touch Develop editor.

Your projects are saved in local browser storage. You can save a Touch Develop script from the web app by clicking the Save button on the script's home page. This will create a JSON file that you can save. You can later drag-and-drop that file into the web app (running locally or via the web site) to load the script again.

Other pages of interest:

Archived landing page: https://web.archive.org/web/20171201223140/https://www.touchdevelop.com/
Archived blog: https://web.archive.org/web/20180627160233/https://www.touchdevelop.com/blog
Archived Hour Of Code tutorials: https://web.archive.org/web/20170328092346/https://www.touchdevelop.com/hoc

What's in this repo?

The repo is mostly written in TypeScript with tiny pieces of HTML gluing.

This repo contains the source code for:

the browser client
the compiler
the editor
the runtime
the node.js client

The cloud backend for Touch Develop is available in TouchDevelop-backend repo. It was originally written in Touch Develop itself (see script tdlite if you're interested) and was later converted to TypeScript. It is currently used for the BBC micro:bit as well as https://www.touchdevelop.com.

Setup

In order to build Touch Develop, ensure that you have Git and Node.js installed.

clone a copy of the repo:

git clone https://github.com/Microsoft/TouchDevelop.git

change to the Touch Develop directory:

cd TouchDevelop

install dependencies:

npm install jake -g
npm install tsd@next -g
tsd reinstall
npm install

Building

There's different ways to build and run Touch Develop:

just build:

jake

You can generate source maps by defining the env variable TD_SOURCE_MAPS

export TD_SOURCE_MAPS=1 # optional, will slow down your build

build and run locally:

jake local

build and copy static files to build/static:

jake static

run the test suite

jake test

cleaning

jake clean

Arduino compilation on Windows

These steps install the tools for Windows (+ extras to handle the Arduino compilation scenarios)

install Chocolatey
install nodejs, Visual Studio Code

choco install -y nodejs git visualstudiocode arduino python2 pip

Editing

You can use your favorite editor to edit the TypeScript file. Here are a couple tips:

Visual Studio Code, cross platform editor for TypeScript. Simply open the folder in Code.
Atom: there are a number of packages that will give you TypeScript coloring

Documentation

All the docs are available online at https://www.touchdevelop.com/docs.

The docs are authored as Touch Develop scripts in Touch Develop itself. You can fork them and send pull requests from Touch Develop itself to update them.

More handy commands

Our catch-all tool is build/client.js, which is compiled from tools/client.ts. Some of the common invocations of client.js are exposed as Jake targets.

# assumes TD_UPLOAD_KEY and TD_UPLOAD_USER are set, uploads a new test build
jake upload

Find out about other commands directly:

node build/client.js

The client.js is built by default.

The various directories in the tree

ast: contains the lexer, parser, type-checker and ast definitions for the Touch Develop language
browser: feature-detection
editor: the Touch Develop user interface that drives the website: hub, script list, editor itself
generated: files needed for the build that are re-generated manually once in a while
intellitrain:
json:
lib: the libraries exposed to Touch Develop scripts, written in TypeScript
libcordova: Apache Cordova specific implementations
libnode: Node.JS specific implementations
libwinRT: (deprecated) WinRT specific implementations
mc: Minecraft bindings
noderunner: runs in the cloud, and parses Touch Develop scripts / compiles them by responding to requests on /api.
node-webkit: configuration files for the node-webkit app creation
officemix: office mix app host
rt: various run-time support libraries for the Touch Develop application: in-browser storage, cloud connection, promises, DOM utilities...
runner: the run-time system for generated Touch Develop apps; that is, once a Touch Develop script is packaged as an app (webapp, cordova app, etc.), runner.js is the runtime system and the stub is in webapp
shell: shell app used by Azure and node-webkit; basically a way to serve files locally
storage: code for syncing your locally-stored scripts and the cloud storage, in the Touch Develop application
tools: internal tools that are part of the build (pre-processing)
webapp: the stub file that is used to generate the HTML5 Web App when exporting a script
www: the base files that make up the Touch Develop website (html and css)

Structure of the generated website / app

When packaged with jake static, the directory structure is flat. That is, the CSS and HTML files from www/ as well as the generated .js files from build/ all end up in the same directory. That way, index.html can refer to main.js without worrying.

When running locally (via jake local), the local node server knows where to find the right files to give the illusion that all files are in the /editor/local/ directory of the web server.

LICENSE

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

3rd Party Notices

Font Awesome by Dave Gandy http://fontawesome.io

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.

timgott/TouchDevelopApp