twbs
/
ratchet
зеркало из
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность
Build mobile apps with simple HTML, CSS, and JavaScript components.
172 коммитов 4 Ветки 6 Теги 15 MiB
SCSS 63.9%
JavaScript 34.7%
HTML 1.4%
Перейти к файлу
connors 04ee7a7281 Fixing a demo bug 2013-09-14 22:35:05 -07:00
dist Fixing a demo bug 2013-09-14 22:35:05 -07:00
docs Experimenting with filled buttons 2013-09-14 19:28:42 -07:00
lib Fixing a demo bug 2013-09-14 22:35:05 -07:00
test Fixing a demo bug 2013-09-14 22:35:05 -07:00
.gitignore rmeove dist from gitignore 2012-11-04 22:25:22 -08:00
CONTRIBUTING.md first commit 2012-11-04 16:03:39 -08:00
Gruntfile.js Comments and style change to sass 2013-09-14 14:24:30 -07:00
LICENSE first commit 2012-11-04 16:03:39 -08:00
README.md Updating readme 2013-08-13 22:52:33 -07:00
component.json Updating version numbers. 2013-08-04 17:10:42 -07:00
package.json Setting up basic variables. 2013-09-13 15:40:18 -07:00

README.md

Ratchet v2.0 WIP

Prototype mobile apps with simple HTML, CSS and JS components.

Getting Started

  • Clone the repo git clone git@github.com:maker/ratchet.git or just download the bundled CSS and JS
  • Read the docs to learn about the components and how to get a prototype on your phone
  • We will have example apps to check out very soon!

Take note that our master branch is our active, unstable development branch and that if you're looking to download a stable copy of the repo, check the tagged downloads.

Support

Ratchet was developed to support iOS 5+ for iPhone. Questions or discussions about Ratchet should happen in the Google group or hit us up on Twitter @goRatchet.

Reporting bugs & contributing

Please file a GitHub issue to report a bug. When reporting a bug, be sure to follow the contributor guidelines.

Troubleshooting

A small list of "gotchas" are provided below for designers and developers starting to work with Ratchet

  • Ratchet is designed to respond to touch events from a mobile device. In order to use mouse click events (for desktop browsing and testing), you have a few options:
    • Enable touch event emulation in Chrome (found in the overrides tab in the web inspector preferences)
    • Use a javascript library like fingerblast.js to emulate touch events (ideally only loaded from desktop devices)
  • Script tags containing javascript will not be executed on pages that are loaded with push.js. If you would like to attach event handlers to elements on other pages, document-level event delegation is a common solution.
  • Ratchet uses XHR requests to fetch additional pages inside the application. Due to security concerns, modern browsers prevent XHR requests when opening files locally (aka using the file:/// protocol); consequently, Ratchet does not work when opened directly as a file.
    • A common solution to this is to simply serve the files from a local server. One convenient way to achieve this is to run python -m SimpleHTTPServer <port> to serve up the files in the current directory to http://localhost:<port>

Authors

Dave Gamache

Connor Sears

Jacob Thornton

License

Ratchet is licensed under the MIT License.