For context as to the motivation of the project, see:
- a youtube video (that's already dated, but better than nothing): http://www.youtube.com/watch?v=RaRIdLgZTPI&feature=youtu.be
- some words written before any code was written: https://github.com/mozilla/appmaker-words/wiki
- the ROADMAP.md and CONTRIBUTORS.md documents in this directory.
Execute npm install
in the application directory:
Get the submodules:
git submodule update --init --recursive
You'll also need to run the appmaker-components server, located at https://github.com/mozilla/appmaker-components
Copy and edit your .env file. -- This should never be committed to the repo.
cp sample.env .env
A short explanation of a complete .env
file:
COOKIE_SECRET=A long, complex string for cookie encryption.
ASSET_HOST=Location of the javascript, css, fonts, and images that will be used by the designer and published assets.
COMPONENTS_BASE_URL=An appmaker-components repo which Ceci will query. Likely "//appmaker-components.herokuapp.com/"
S3_BUCKET=S3 bucket name. e.g. "my.coolappmaker.com"
S3_KEY=An access key for the S3 bucket listed above.
S3_SECRET=The secret corresponding to the specified S3 access key.
S3_OBJECT_PREFIX=String to prepend S3 objects. Useful for storing objects in folders. E.g. "level1/level2" => <bucket>/level1/level2/<filename>.
PUBLISH_URL_PREFIX=String to prepend to filenames that are saved on S3. Try use the URL that matches the protocol from which assets are hosted to avoid mixed content blockage.
foreman start
If you need foreman:
sudo gem install foreman
The purpose of this Style Guide is to provide a single reference for visual styles and design elements used in Appmaker.
The overall design approach is based on making building apps fun and gamelike. We want the site’s content and design to:
- Encourage play and exploration
- Encourage non developers to think like programmers
- Enable anyone to build and customize apps that matter to them.
The visual guidelines outlined here are based on Appmaker’s fundamental characteristics, communicating a sense of fun, exploration, and play while building a space where developers and non developers can collaborate to create new and meaningful apps.