Skip to content


Subversion checkout URL

You can clone with
Download ZIP
An intuitive software erector kit targeted at people new to programming, but with enough potential to stay useful once they've learned, inspired by HyperCard.
C++ Objective-C++ Objective-C C HTML PHP Other

Don't crash with table fields that have text styles on image columns …

…(like the TableViewTest sample, or any table where the text column has been converted from styled text to icon).
latest commit ccf02bd4a6
@uliwitness authored
Failed to load latest commit information.
Forge @ d5f7e8a
ForgeDebugger @ 87568a9 Turn on remote debugger again.
KVOWithBlocks @ 5740134 Track KVOWithBlocks HEAD.
Sparkle @ dd12b84 Grab more comments & project settings shut-up commits from submodules.
Stacks @ e1c0747 Pull in an additional template that does a bit of icon animation usin…
Stacksmith Don't crash with table fields that have text styles on image columns …
UKDistributedView @ b337fa5 Stack canvas now shows something for unnamed objects and looks a bit …
UKPaintView @ 038eb23 Shut up to warnings about use of wrong version of the abs function.
UKSyntaxColoredTextDocument @ 4da7c7d Hook up indentation in script editor to the tab key, maintaining the …
ULIMelodyQueue @ 0fcb5d7 Track ULIMelodyQueue HEAD.
ULINetSocket @ cc68aac Made all dependencies subprojects
ULIWideningBezierPath @ 5d6eda0 WIP on variable-width line drawing for bezier paths and lines. Right …
UliKit @ 5c8fec4
stackimport @ f7f93f4 New version of Stackimport with a --rawgraphics option to avoid runni…
tinyxml2 @ b02b8d9 Track tinyxml2 HEAD. We should now be back on the mainline, without a…
.gitignore Fix ignores and track Leonie HEAD.
.gitmodules No longer use SSH key for auth.
HeaderDocTOCTemplate.html Slight corrections to auto-generation of API docs. Update Readme's description of how the debugger works.
build_docs.command Build docs faster.
headerDoc2html.config Slight corrections to auto-generation of API docs.
nightly_build_and_upload.command Add script to repository that builds a Stacksmith nightly build as a …
writerss.php Add script to repository that builds a Stacksmith nightly build as a …

What is it

In short, Stacksmith is a HyperCard clone that runs on the current version of Mac OS X.

How to build

Make sure you've inited all the submodules (especially the Leonie sub-submodule of the Forge submodule!) using

git submodule update --init --recursive

then just build the Stacksmith Xcode project. If you want to contribute, note that you'll probably have to change the subprojects to point to your own clones of the subprojects. These instructions might be helpful:

Debugging Hammer code

Stacksmith's scripting language (its analog to HyperTalk) is called Hammer. There is a source-level debugger for it in the ForgeDebugger project. To use it, simply click to the left of a line of your script where you want to start debugging. Stacksmith will launch and connect to the separate ForgeDebugger application and display script text and bytecode in it, as well as local variables and the call stack, and even the stack where temporary variables live. Should this not work, you can also try launching the debugger application manually, and inserting a "debug checkpoint" command in your script.

What is what

Stacksmith consists of several parts:

  • Stacksmith - the Hypercard clone proper
  • ForgeDebugger - the debugger. Yes, it's currently a separate application. This will change eventually.
  • Forge - the part that reads scripts and compiles them into a special bytecode. This is written in C++, but its public API consists of a handful of C functions with a LEO prefix. [Cross platform]
  • Leonie - the part that runs bytecode (i.e. the "compiled" scripts generated by Forge). All of the functions in there are prefixed with LEO [Cross platform]
  • stackimport - A command-line tool that Stacksmith uses to import HyperCard stacks. [Almost cross platform]
  • Sparkle, UKPaintView, UKSyntaxColoredTextDocument, UliKit, UKMelodyQueue, ULINetSocket - Mac-specific helper code used to implement various parts of Stacksmith.


Note: Some submodules may be subject to different licenses.

Copyright 2003-2014 by Uli Kusterer.

This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

   1. The origin of this software must not be misrepresented; you must not
   claim that you wrote the original software. If you use this software
   in a product, an acknowledgment in the product documentation would be
   appreciated but is not required.

   2. Altered source versions must be plainly marked as such, and must not be
   misrepresented as being the original software.

   3. This notice may not be removed or altered from any source
Something went wrong with that request. Please try again.