Skip to content
Branch: master
Clone or download
ashfurrow Merge pull request #1579 from artsy/deploy_podspecs
Adds a script for deploying the RN podspecs
Latest commit 1183c13 Apr 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Fixes YML format. Mar 14, 2019
Example 1.10.0 Apr 15, 2019
data Updates relay schema Apr 8, 2019
docs fix typo Apr 8, 2019
images Update map background image sizing Mar 11, 2019
patches [rn upgrade] Convert to use the new NavigationiOS repo instead Apr 9, 2019
scripts Adds a script for deploying the RN podspecs Apr 15, 2019
src [Refactor] Update deprecated Relay `graphql` assignments Apr 10, 2019
storybook Adds correct margin/padding to last carousel image Mar 22, 2019
.babelrc Update the React Native version, and get types up to date Mar 21, 2019
.gitattributes [git] Hide query maps from GitHub diffs. May 4, 2018
.gitignore Adds TS logs. Mar 14, 2019
.gqlconfig [vscode] Enable graphql intellisense/autocomplete etc. Sep 4, 2017
.npmrc [npm] Do not ever write a package-lock.json file. Jan 13, 2018
.nvmrc Update to Node 10 and update affected testing dependencies Oct 31, 2018
.prettierignore Fix CHANGELOG version appender Mar 13, 2019
.stylelintrc Update stylint Nov 27, 2018
.travis.yml Update to Node 10 and update affected testing dependencies Oct 31, 2018
.yarnrc [Toolchain] disable integity check with .yarnrc Oct 30, 2018
Emission.podspec Only includes Podspec metadata on releases. Mar 18, 2019
Makefile Adds cocoapod key after pod install and removes comment from locationmap Nov 21, 2018 README Mar 6, 2019
babel.config.js Update the React Native version, and get types up to date Mar 21, 2019
index.tests.ios.js New entry point for native unit tests. Jan 10, 2019
package.json 1.10.0 Apr 15, 2019
renovate.json Merge master Jan 17, 2019
tsconfig.json Fixes mockData Mar 29, 2019
tslint.json Adds tslint-plugin-relay lint rule. Oct 20, 2018
yarn.lock [package] Bump tipsi-stripe to fix RN compat Apr 9, 2019

Reactions ⇒ Emissions

Emission is a collection of React Native Components which are consumed by Eigen. A writeup on how & why we made a lot of the repo decisions is on our blog here.

Inside Emission you will find:

  • An example app for building and running Emission's components with an Eigen-like API.
  • An NPM module that relies on React Native and manages the components.
  • A Podspec that wraps it all together for easy external usage in Eigen.


This is a core Artsy Mobile OSS project, along with Energy, Eidolon, Eigen and Emergence.

Don't know what Artsy is? Check out this overview and more, or read our on team culture.

Want to know more about Emission? Read the mobile blog posts, or Emission's / React Native's specifically. Also check out the map to Emission to oriented yourself to the codebase.


  • Xcode


Automated install:

  • OSS: git clone && cd emission && make setup && make oss
  • Artsy: git clone && cd emission && make setup && make artsy. Then look in 1password for the Eigen keys.

Manual install

  1. Install Node.js, and Yarn: $ brew install node yarn
  2. Install file watcher used by React Native:
    • $ brew install watchman
  3. Install NPM modules: $ yarn install
  4. Install Pods: $ cd Example && bundle && bundle exec pod install

Ran into issues? Try troubleshoot.

Running the project:

  1. Run $ yarn start from the top directory, which will:

    • Clean the example app’s Xcode build dir.
    • Start the example app’s React Native packager.
    • Start the React Storybooks environment.
  2. Now from Xcode you can run the app in Example/Emission.xcworkspace.

  • If you already have the app installed, you can run open -a Simulator to open the last sim, and then xcrun simctl launch booted net.artsy.Emission to open the app.
  • If you run into any issues with the above commands oftentimes a full clean can help. Run rm -rf node_modules; rm -rf Example/Pods; yarn install; cd Example; bundle exec pod install and then repeat the steps above.

Daily Development

To use Storybooks, select "Open Storybook" from the "Developer" section of the root view in the app. You can also use the VSCode Storybooks plugin.

Using VS Code as an IDE

There is a comprehensive document covering our setup here.


There is a comprehensive document covering the various options.

Updating Dependencies

We vendor some data from other repositories that you will sometimes need to update. Notably the GraphQL schema of metaphysics that Relay uses to generate queries from: $ yarn sync-schema

Deploying Emission

Note: Deploys are mostly automated using yarn release patch|minor|major; the following instructions should be valid but take a look at this issue if things break.

Note 2: If you're updating React Native, you're gonna have to do a lot of this stuff manually. See the makefile/alloy/orta for more info.

  1. Update the CHANGELOG file to reflect the version that will be released and commit it.
  2. Don't change the package.json version.
  3. For non-beta releases, use either yarn release patch, yarn release minor, or yarn release major. For beta releases use yarn release prerelease.
  4. If integrating in Eigen consult the docs on updating Emission

Automated Emission App Deploys

The Emission app (in Example/) is deployed automatically to TestFlight once a week through emission-nebula. See that repo for more details.


You can’t perform that action at this time.