Named after the artist, kaws is a backend service that powers artsy.net collection pages. What are collections you ask? A Collection is a prefiltered version of Artsy's Collect page for marketing purposes.
- State: in development
- Production: http://kaws.artsy.net | k8s
- Staging: http://kaws-staging.artsy.net | k8s
- GitHub: https://github.com/artsy/kaws/
- CI: CircleCI; merged PRs to
artsy/kaws#master are automatically deployed to staging. PRs from
staging
torelease
are automatically deployed to production. Start a deploy... - Point People: @l2succes
- node.js 8.12.0 or newer
- yarn 1.10.1 or newer
- MongoDB 4.x
First, make sure to install dependencies:
yarn
We use the .env
file to load environment-specific variables. Copy
.env.example
to .env
so dotenv will
automatically load them upon app boot:
cp .env.example .env
Usually you do not have to change them, but if you need, update the variables to match your local development setup.
Once this is done, the next step would be to load test data. The collection data
is maintained by Artsy's marketing team in Google Drive as a spreadsheet
(you need an @artsymail.com
account). Download it as a CSV file (in this case
saved as collections.csv
) and try running the command below to load the data
to your local MongoDB instance:
yarn update-database ./collections.csv
Finally, start the server by running the command below:
yarn dev
Then open http://localhost:4000/playground and you should see Apollo's GraphQL
Playground. Try running the GraphQL query below, and if you see
"KAWS, Companions"
and "Pablo Picasso, Lithographs"
you are good to go!
query {
collections {
id
slug
title
}
}
yarn jest
Metaphysics is the current consumer of Kaws GraphQL schema, and keeps a copy of its latest schema in https://github.com/artsy/metaphysics/tree/master/src/data. If you have made changes to the Kaws GraphQL schema, make sure you also update the copy of this schema in Metaphysics. In order to do so follow these steps:
- In kaws run
yarn dump-schema
- copy the
_schema.graphql
file generated ☝🏼 tokaws.graphql
cp _schema.graphql kaws.graphql
- move the file above to your local Metaphysics under
src/data
and make a PR to Metaphysics with this change.
When we update the production database with the update-database
command, we
also need to inform Google of the updates so newly added collections will be
crawled. This could be done with the update-sitemap
command. This comamnd
needs to be run in the k8s container as it neeeds to point to the production
databse:
hokusai production run 'yarn update-sitemap'