Welcome to Cappuccino!
Cappuccino is an open source framework that makes it easy to build desktop-caliber applications that run in a web browser.
With Cappuccino, you don't concern yourself with HTML, CSS, or the DOM. You write applications with the APIs from Apple's Cocoa frameworks and the Objective-J language.
Check out a live demo of the widgets in Cappuccino
Check out some tutorials
For more information, see the
Follow @cappuccino on Twitter for updates on the project.
If you discover any bugs, please file a ticket.
To run Cappuccino applications, all you need is a HTML5 compliant web browser.
You can develop Cappuccino applications with only a simple text editor on any platform.
If you are on a Mac, our integration with Xcode leverages the world-class visual development tools from Apple to create complex applications with minimal coding.
Node.js version alpha
Install Node.js and npm from the Node.js website.
npm set prefix ~/.npm. This will set the default install location for npm to
~/.npm. The reasoning behind this is outlined in the section about permission issues below.
Add this line to your
.zshrcor equivalent config file.
Restart your shell.
npm install -g @objj/cappuccino.
Done! See below for basic usage.
By default npm uses
/usr/local/lib/node_modules as the install location for globally installed packages. This causes
problems since users typically lack write permissions there. It is therefore recommended to either use a version
manager, or change npm's default install location manually (which is what we did above). For more details on how to do
this, see this article.
If the install succeeded you will be able to do the following to create a simple Cappuccino application:
capp gen HelloWorld
python3 -m http.server
- Go to
localhost:8000in your web browser.
Building Cappuccino from source
If you want to build Cappuccino from source you should clone the GitHub repository at
https://github.com/cappuccino/cappuccino/ and checkout the
node branch. Then you can use the command
jake install to install Cappuccino and its tools locally.
To build from source, do:
git clone https://github.com/cappuccino/cappuccino.git
git checkout node
Make any desired changes to the codebase.
Make sure the environment variable
CAPP_BUILDis set. This is done by adding the line
.zshrcor equivalent config file and of course changing the path to where you want to build Cappuccino.
jake installto build and install Cappuccino.
Beware that building and installing Cappuccino from source will overwrite the binaries installed from npm. To undo this,
npm install -g @objj/cappuccino again.
To write you first application, download the starter package.
To try our new Node (alpha) version of the Cappuccino framework, check the Node installation instructions
To contribute to Cappuccino, please read here: Getting and Building the Source.
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA