gatsby-source-bgg

Source plugin for pulling game collections from BoardGameGeek into Gatsby. It creates links between entry types and assets (e.g. cover images) so they can be queried in Gatsby using GraphQL.

At a glance

Getting started

First, install the package

# npm install gatsby-source-bgg
yarn add gatsby-source-bgg

Then, in your gatsby-config.js add the plugin and configure it with all the filters and options you like. The only required field is username. Here you can find a complete list of options.

The options are a 1:1 mapping of the API options you can find on BoardGameGeek's documentation.

module.exports = {
  plugins: [
    {
      resolve: "gatsby-source-bgg",
      options: {
        username: "tommasoamici",
        own: 1,
      },
    },
  ],
};

You will then be able to query the games as usual with GraphQL queries, e.g.

query GamesList {
  games: allBggGame {
    edges {
      node {
        name
        numPlays
        coverImage {
          childImageSharp {
            gatsbyImageData(height: 256, width: 256, formats: [AUTO, WEBP])
          }
        }
      }
    }
  }
}

Example output:

{
  "data": {
    "games": {
      "edges": [
        {
          "node": {
            "name": "7 Wonders Duel",
            "numPlays": 5,
            "coverImage": {
              "childImageSharp": {
                "gatsbyImageData": {
                  "layout": "constrained",
                  "backgroundColor": "#282828",
                  "images": {
                    "fallback": {
                      "src": "/static/283f546e590850a05dfea6196db90991/68974/pic3376065.jpg",
                      "srcSet": "/static/283f546e590850a05dfea6196db90991/d4a57/pic3376065.jpg 64w,\n/static/283f546e590850a05dfea6196db90991/19e71/pic3376065.jpg 128w,\n/static/283f546e590850a05dfea6196db90991/68974/pic3376065.jpg 256w,\n/static/283f546e590850a05dfea6196db90991/3c367/pic3376065.jpg 512w",
                      "sizes": "(min-width: 256px) 256px, 100vw"
                    },
                    "sources": [
                      {
                        "srcSet": "/static/283f546e590850a05dfea6196db90991/8257c/pic3376065.webp 64w,\n/static/283f546e590850a05dfea6196db90991/6766a/pic3376065.webp 128w,\n/static/283f546e590850a05dfea6196db90991/22bfc/pic3376065.webp 256w,\n/static/283f546e590850a05dfea6196db90991/d689f/pic3376065.webp 512w",
                        "type": "image/webp",
                        "sizes": "(min-width: 256px) 256px, 100vw"
                      }
                    ]
                  },
                  "width": 256,
                  "height": 256
                }
              }
            }
          }
        }
      ]
    }
  },
  "extensions": {}
}

Found a bug?

Please file a report in this repository's issues

Development

If you want to contribute to this project, that's great to hear!

You can start at CONTRIBUTING.md.

Cannot read property 'result' of undefined

What version of gatsby-source-bgg are you using?

1.0.8

What version of Node.js are you using?

14.17.1

Describe the Bug

"gatsby-source-bgg" threw an error while running the sourceNodes lifecycle:

Cannot read property 'result' of undefined

TypeError: Cannot read property 'result' of undefined

polls.ts:18 Object.processSuggestedAgePoll
/Users/tamici/dev/personal/tommasoamici.com/.yarn/$$virtual/gatsby-source-bgg-virtual-715b
bd8e9c/2/gatsby-source-bgg/src/polls.ts:18:16
index.ts:52
/Users/tamici/dev/personal/tommasoamici.com/.yarn/$$virtual/gatsby-source-bgg-virtual-715b
bd8e9c/2/gatsby-source-bgg/src/index.ts:52:27
Array.map
index.ts:13 Object.processData
/Users/tamici/dev/personal/tommasoamici.com/.yarn/$$virtual/gatsby-source-bgg-virtual-715b
bd8e9c/2/gatsby-source-bgg/src/index.ts:13:15
index.ts:125
/Users/tamici/dev/personal/tommasoamici.com/.yarn/$$virtual/gatsby-source-bgg-virtual-715b
bd8e9c/2/gatsby-source-bgg/src/index.ts:125:12
index.js:32 step
/Users/tamici/dev/personal/tommasoamici.com/.yarn/$$virtual/gatsby-source-bgg-virtual-715b
bd8e9c/2/gatsby-source-bgg/dist/index.js:32:23
index.js:13 Object.next
/Users/tamici/dev/personal/tommasoamici.com/.yarn/$$virtual/gatsby-source-bgg-virtual-715b
bd8e9c/2/gatsby-source-bgg/dist/index.js:13:53
index.js:4 fulfilled
/Users/tamici/dev/personal/tommasoamici.com/.yarn/$$virtual/gatsby-source-bgg-virtual-715b
bd8e9c/2/gatsby-source-bgg/dist/index.js:4:58
runMicrotasks
task_queues.js:95 processTicksAndRejections
internal/process/task_queues.js:95:5

Expected Behavior

No response

To Reproduce

No response

tommasoamici / gatsby-source-bgg Goto Github PK