Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

JavaScript OS X App Examples


06/15 - OS X 10.11 Release Notes

OS X 10.11 includes a number of updates to JSX

Sandboxing info:


Developer preview 7 has fixed the major issues that were in dev preview 5. All of the demos are working again.

I updated the Radar:


A good number of the demos are crashing. Any demo that has a button that you can click that does something will crash. (HandleBtnClick, NSOpenPanel, etc.)

I have a question up on the Apple dev forums:

I've submitted a bug to Apple, and it's copied on Radar:

What is this?

Starting with OS X 10.10, Yosemite you can use JavaScript to create native Cocoa applications. I wrote a big ole post to help get you started.

This is a collection of examples showing how to create many of the common components used in OS X Applications. The goal is to help people learn how to build apps by showing clear, atomic examples.

These aren't exhaustive examples. Most of them are as basic as possible. The idea isn't to show everything that can be done, it's to give a solid foundation to get you started.


You can run any of the example apps by double clicking them.

If you are running the app while editing from Script Editor, there are two different ways. Script > Run (cmd + r) is the normal run. This can be good for quick debugging, but the app will not act like the application and is usually not what you want. You'll want Script > Run Application (cmd + opt + r).


To view and edit the code for each example you will need to use the Script Editor application. It is located in Applications > Utilities > Script Editor. From there you can either File > Open any of the example apps or drag the example app icon to the Script Editor in the dock.

How to create an app

Since using JavaScript to create apps is new there's not much documentation. We've had the ability to do all of this with AppleScript for years, but I haven't had much luck finding thorough docs on that either.

Here's a couple of gotchas that had me scratching my head for some time.

To create a new application:

  • Open a new document in Script Editor cmd+n
  • Save the document cmd+s
  • When prompted with the Save dialog, name your app, set the file format to Application, and make sure you check the Stay open after run handler option.

NOTE: If you do not check the Stay open... option on the save dialog there does not appear to be a way to update this later. (I hope I'm wrong, but haven't found a way to do it yet). If the option isn't checked pretty much nothing is going to work how you expect it.

Code Signing

Apps created this way can be code signed. Signing your app is helpful if you are planning to distribute it to other people. Code Signing is a broad topic, for details check out


JavaScript for Automation Release Notes

Check out the WWDC presentation on JavaScript for Automation You'll need an Apple Developer Account.


Example OS X applications written in JavaScript.







No releases published


No packages published