2015-08-26 03:51:24 +00:00
|
|
|
# Natal
|
2015-08-30 04:01:40 +00:00
|
|
|
### Bootstrap ClojureScript-based React Native apps
|
|
|
|
[Dan Motzenbecker](http://oxism.com), MIT License
|
|
|
|
[@dcmotz](https://twitter.com/dcmotz)
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
Natal is a simple command-line utility that automates most of the process of
|
|
|
|
setting up a React Native app running on ClojureScript.
|
|
|
|
|
|
|
|
It stands firmly on the shoulders of giants, specifically those of
|
|
|
|
[Mike Fikes](http://blog.fikesfarm.com) who created
|
|
|
|
[Ambly](https://github.com/omcljs/ambly) and the
|
|
|
|
[documentation](https://github.com/omcljs/ambly/wiki/ClojureScript-React-Native-Quick-Start)
|
|
|
|
on setting up a ClojureScript React Native app.
|
|
|
|
|
2015-08-30 04:02:14 +00:00
|
|
|
|
|
|
|
## Usage
|
|
|
|
First, install the CLI using npm:
|
|
|
|
|
|
|
|
```
|
|
|
|
$ npm install -g natal
|
|
|
|
```
|
|
|
|
|
|
|
|
Then run `natal` with your app's name as the first argument:
|
|
|
|
|
|
|
|
```
|
|
|
|
$ natal FutureApp
|
|
|
|
```
|
|
|
|
|
|
|
|
If your app is more than a single word, be sure to type it in CamelCase.
|
|
|
|
A corresponding hyphenated Clojure namespace will be created.
|
|
|
|
|
2015-08-30 04:02:33 +00:00
|
|
|
## Tips
|
|
|
|
- Natal requires npm, Leiningen, and CocoaPods to be installed
|
|
|
|
- Having `rlwrap` installed is optional but recommended since it makes the REPL
|
|
|
|
a much nicer experience with arrow keys
|
|
|
|
- Don't press ⌘-R in the simulator; code changes should be reflected automatically.
|
|
|
|
See [this issue](https://github.com/omcljs/ambly/issues/97) in Ambly for details.
|
|
|
|
- Running multiple React Native apps at once can cause problems
|
|
|
|
|