TouchDevelop is a touch-friendly app creation environment for iPad, iPhone, Android, Windows, Mac, Linux. Our mobile-friendly editor makes coding fun, even on your phone or tablet!
TypeScript JavaScript HTML CSS C# Smalltalk
Latest commit c4facd5 Dec 19, 2016 @pelikhan pelikhan Merge branch 'bbcmicrobit'
Permalink
Failed to load latest commit information.
.vscode support for invoking jake from VS code Jan 8, 2016
ast Minor converter changes Apr 13, 2016
browser removing webappbooster support Dec 11, 2015
editor Merge branch 'bbcmicrobit' Dec 19, 2016
embedded display save button for compile dialog. fix for bbc/microbit-extras#2824 Feb 8, 2016
fonts embed symbol font in printed css Sep 1, 2015
generated Getting latest CrowdIn strings Jun 15, 2016
images replace script list BBC logo Dec 19, 2016
intellitrain Fix line endings Feb 4, 2015
json Fix line endings Feb 4, 2015
lib Adding more loc hooks for a few more strings Jun 2, 2016
libcordova more cordova fix Jul 16, 2015
libnode Add btoa/atob in node.js Dec 14, 2015
libraries merging changes Apr 4, 2016
locales Getting latest CrowdIn strings Jun 15, 2016
microbit Merge branch 'bbcmicrobit' Dec 19, 2016
node-webkit Fixing "TouchDevelop" text and adding loc hooks Dec 11, 2015
noderunner remove c++ compilation from test suite Jun 15, 2016
officemix Fixing "TouchDevelop" text and adding loc hooks Dec 11, 2015
rt Merge branch 'bbcmicrobit' Dec 19, 2016
runner Fixing "TouchDevelop" text and adding loc hooks Dec 11, 2015
shell Always allow encrypted connections in shell; use npm install --produc… Apr 14, 2016
storage Adding loc hooks, fixing "Touch Develop" references in strings May 27, 2016
tools Merge branch 'bbcmicrobit' Aug 9, 2016
webapp Updating the "just a moment" text - no loc needed now Feb 25, 2016
www adding group expiration notices Aug 9, 2016
.ackrc removing embedded docs in favor of online/pointer version of docs. Dec 10, 2015
.gitattributes don't enforce unix line encoding for unknown file types (fonts) Aug 31, 2015
.gitignore removing radio library. fix for bbc/microbit-extras#2997 Mar 31, 2016
.travis.yml don't specify minor version of node Jun 2, 2015
.tsdrc Re-instate TSD as part of the build. Feb 10, 2015
CONTRIBUTING.md Fixing "TouchDevelop" text and adding loc hooks Dec 11, 2015
Jakefile removing c++ compiler test Jun 22, 2016
LICENSE Updating copyright on GitHub in two spots Jan 8, 2016
Makefile remove old stuff from the Makefile Feb 11, 2015
README.md Update README.md Jun 21, 2016
package.json updated to v55, refactored microbitGitTag Jan 19, 2016
tsd.json prototpye of C++ project export Jan 8, 2016
vs.sln redirect large tutorial button to theme tutorials Apr 3, 2015
vsrefs.ts removing webappbooster support Dec 11, 2015

README.md

Touch Develop is a touch-friendly, cross-platform, mobile-first app creation environment developed with <3 at Microsoft Research. Build Status

Dependency Status devDependency Status

This repo contains the source code of the Touch Develop editor. If you are intending to write Touch Develop scripts, you want to go to touchdevelop.com:

If you want to always run the latest build,

The make sure which version you're running, tap the small copyright/legal/version bar in the bottom right, and then the latest changes button. This will give you the changes that went into your current version, and in particular if the fix for your submitted issue is in. If the expected change is not there, try reloading the page. Keep in mind that the build process takes a few minutes.

Other pages of interest:

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 next-generation 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 and will be deployed at https://www.touchdevelop.com shortly.

Contributing

There are many ways to contribute to Touch Develop.

If you're not a developer but still would like to help, we've got more tasks for you!

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

Quick Windows setup

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

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
  • run packaged as a [nwjs] app:
jake nw
  • run the test suite
jake test
  • cleaning
jake clean

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, as the website or as an app, 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)

Copyright (c) 2016 Microsoft

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

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.