76 lines
2.1 KiB
Markdown
76 lines
2.1 KiB
Markdown
# Natal
|
|
### 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.
|
|
|
|
|
|
## 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.
|
|
|
|
When Xcode appears, click the play button to run the app on the simulator.
|
|
|
|
Then run the following for an interactive workflow:
|
|
|
|
```
|
|
$ cd future-app
|
|
$ ./start.sh
|
|
```
|
|
|
|
First, choose the correct device (Probably [1]). At the REPL prompt type this:
|
|
|
|
```clojure
|
|
(in-ns 'future-app.core)
|
|
```
|
|
|
|
Changes you make via the REPL or by changing your .cljs files should appear live.
|
|
|
|
Try this command as an example:
|
|
|
|
```clojure
|
|
(swap! app-state assoc :text "Hello Native World")
|
|
```
|
|
|
|
|
|
## 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
|
|
|
|
|
|
## Aspirations
|
|
- [ ] Automatic wrapping of all React Native component functions for ClojureScript
|
|
- [ ] Xcode-free development with CLI tools
|
|
- [ ] Automatically run React packager in background
|
|
- [ ] Automatically tail cljs build log and report compile errors
|
|
- [ ] Templates for other ClojureScript React wrappers
|
|
|
|
|
|
Contributions are welcome.
|