Home

Introduction

These documents were written to help Clojurescript developers get up to speed developing a React Native app. It's based on a series of documented decisions with associated tradeoffs & consequences so it represents one path through the maze.

If you accept the design decisions made it provides an approach through many cross cutting concerns allowing you to start adding business value faster.

Goals

Goals of this repo/project is a "zero-feature" release. That is to say we're delivering an app has all necessary building blocks to start adding custom features and have established the processes for developing, testing and releasing.

Documentation

Choosing tools

• Choosing React Native
• Choosing Clojurescript
• Choosing re-frame
• Choosing re-natal

Housekeeping

• ADR: React Native CLI vs Expo
• ADR: Account management
• ADR: Yarn for package management
• Clojurescript coding conventions
• Write debuggable code
• Keyword hygiene and the "grep test"
• Fixing advanced compilation bug

Getting started

• Do the React Native CLI Quickstart
• Do the re-natal setup process

What do you get out of the box?

• What do you get when you run "react native init MercuryApp"?
• What does re-natal add over the react-native template?
• Clear out unnecessary template files

Development and debugging setup

• Figwheel used for REPL and live coding
• Setting up Cursive for REPL based development
• Remote JS debugging in Chrome
• Instrumenting functions with spec

Minimum deployable app

• App Icons
• Navigating between screens
• Storing data in the app

iOS release process

• Account setup: Apple Developer Program
• One-off setup: Certificates
• App Store listing
• Releasing iOS app

Android release process

• One-off setup: Generating a signing key
• Account setup: Google Play Console
• Google Play Store listing
• Releasing Android app