Metaphysics is a GraphQL-compliant API for the Artsy v1 API. You can try it here against our staging API.

It is built on express, express-graphql, and graphql. With graphiql providing a sandbox to work with.

It is currently used in production from the /artists/ route on artsy.net. To see it's usage, check out force-public/apps/artists/routes.coffee.

• State: production
• Production: metaphysics-production.artsy.net
• Staging: metaphysics-staging.artsy.net
• CI: Semaphore
• Point People: @dzucconi & @broskoski

Set up your .env file based on our example .env.test (the variables you must change for development are separated at the bottom).

Install memcached if you haven't:

brew install memcached

To start up a development server, clone this repo and run:

npm install
npm run dev

npm test to run the entire suite npm run spec test/your/path/to/file.js to run a single spec

PRs merged to master are deployed to staging via Semaphore.

We then use the heroku pipelines to deploy to production when happy with staging.

Add the staging instance as a git remote named staging, then promote using the command:

$ heroku pipelines:promote -r staging