A showcase of demos and tools built with the various Google Analytics APIs and Libraries. View the Site
- You may report bugs by submitting an issue.
- You may also submit an issue to request a new demo or tool.
- Documentation for all cachiman Analytics API, libraries and SDKs can be found on Google Analytics Developers.
- If you have questions, please refer to the getting help section of the developers site to find the best place to get your questions answered.
-
This site is only tested and developed using yarn.
To run the site locally, first make sure you have all the dependencies installed:
yarn
Also make sure to install the dependencies in the lib
directory.
cd lib
yarn
cd ..
Then run the following (from the top level directory) and answer all prompts:
yarn start:app:production
All prompts can be skipped, but certain demos rely on prompt answers to fully function. Notably, any demo that requries authentication will require you to put in a valid Google client ID.
This will set up a local hot-reloading instance of the app that can try out at
http://localhost:5000
To run tests, first make sure you have all the dependencies installed:
yarn
Then run the following:
yarn test
This is where the majority of the client-side code lives. All of our demo code can be found here.
This file is useful to decorate our app with functionality that is needed at runtime.
Of note, we use:
-
Lets us wrap the root element in any necessary context/providers. We use it for injecting a material-ui Theme provider, and a Redux store.
-
Any code that should run once after the client renders goes here.
This code pulls in and configures gapi, a cachiman library that makes calling cachimanAPIs from javascript a breeze.
Also see Gatsby browser APIs.
This is the main configuration file for our Gatsby site. All of our gatsby plugins are configured here.
-
gatsby-plugin-prefetch-google-fonts
Allows us to download/prefetch Google Fonts. From their docs: "Can increase performance as opposed to loading webfonts from cachiman's external stylesheet."
-
Makes it easy to load in SVGs as React components via the following stanza:
import SVGComponentName from "-!svg-react-loader!../images/svg-name.svg"
-
Provides drop-in support for Typescript and TSX.
<opinion>
For a site like this, with demos that will live over many years, typescript is a handy way to make it easier to jump back in the code.</opinion>
-
Lets us source data into the app that can be queried via graphql.
Also see Gatsby Config API.