imcyee / eigen

The Art World in Your Pocket or Your Trendy Tech Company's Tote, Artsy's iOS app.

Meta

• State: production
• Point People: Brian Beckerle, David Sheldrick
• CI :

This is an Artsy OSS project. Other mobile projects are Energy and Eidolon, with the retired Emission and Emergence.

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

Want to know more about Eigen? Read the mobile blog posts, or eigen's specifically.

Docs

Get setup here. Further documentation can be found in the documentation folder.

Work at Artsy?

Instead of ./scripts/setup-env-for-oss below, run ./scripts/setup-env-for-artsy. You will need awscli to get our ENV vars.

The file Artsy/App/EchoNew.json is not checked in (a sample file is included for OSS contributors). When you run pod install, the latest EchoNew.json file will be downloaded for you. See note in Podfile.

Quick Start

Note: We currently require using Xcode 12 for development, with the latest version (12.2.0) recommended. You can find all versions of Xcode from Apple's Developer Portal 🔐.

You'll need:

• Node installed (whichever version is listed as the engine here).
• aws cli installed.
• Yarn installed, too.

Want to get the app running? Run this in your shell:

git clone https://github.com/artsy/eigen.git
cd eigen
gem install bundler
bundle install --without development

./scripts/setup-env-for-oss # or ./scripts/setup-env-for-artsy

bundle exec pod install --repo-update
open Artsy.xcworkspace

# finally start the react-native bundler
yarn start

This will set you up on our staging server, you will have a running version of the Artsy app by hitting Product > Run (or ⌘R).

Note: bundle exec pod install may fail the first time you run it (due to a bug in a dependency of ours). Re-running the command should work.

Deployment

For how we deploy, check out the dedicated documentation:

• Deploying a beta
• Deploying to the App Store

Thanks

Thanks to all our contributors.

License

MIT License. See LICENSE.

About Artsy

This project is the work of engineers at Artsy, the world's leading and largest online art marketplace and platform for discovering art. One of our core Engineering Principles is being Open Source by Default which means we strive to share as many details of our work as possible.

You can learn more about this work from our blog and by following @ArtsyOpenSource or explore our public data by checking out our API. If you're interested in a career at Artsy, read through our job postings!