Over the last 12 months, my tutorial on building a gatsby+airtable powered documentation site has been getting a slow but steady trickle of reads. People are excited about this technology!

So it’s finally time to post an update. 12 months have gone by but it’s clear this tech is here to stay.

I’m still using Airtable + Gastby. I still love it!

But not just for documentation sites… I’m using it for full-featured, responsive landing pages, storefronts and more. Here is what this stack gives me:

Image for post
Image for post
  • A near perfect lighthouse score.

81 percent of women and 43 percent of men report having experienced some form of sexual harassment during their lifetime. [1]

Voices are louder than ever, demanding change. With recent viral movements, celebrity admissions and high-profile accusations, we are more familiar with shocking statistics like these, and we are starting to talk.

Unfortunately, abstract numbers and aggregated statistics aren’t enough to change behavior. To solve complex societal problems like harassment, we need to get our communities engaged and focused. We need to connect with each other on a personal level.

And how can we do that? It starts by connecting…

It’s a simple, but powerful concept: asking a bunch of people to mark stuff on a map.

We call it “collaborative and crowd-sourced mapping”, or “crowd-mapping” but there are many other names:

  • VGI — Volunteered Geographic Information

What do these methods all have in common? They all involve asking people “where”. They are enabled by widespread access to the internet, web-mapping technology, rising technical literacy, and social media.

Let’s talk about what we mean by crowd-sourced mapping, and why we think it’s so cool.

Types of crowd-sourced spatial data

It’s important to understand the main…

Image for post
Image for post

A platform for creating, publishing, and contributing to collaborative maps.

In 2017, I helped run a pilot project asking the citizens of Karlsruhe, Germany to map their wants and needs with regards to bicycle infrastructure.

I was amazed at the quality of the contributions and comments our project received — though building and marketing the web-app proved much more difficult than anticipated. I looked at every tool on the market, and found all of them far too expensive, confusing or inflexible.

I realized these tools weren’t capturing the true potential that lies in this wonderful method. So I built my own.

What is collaborative mapping? Also called crowd-mapping, public participation GIS, and many other names — collaborative mapping is the simple act of working together to mark stuff on a…

Walkthrough tutorial for a match made in heaven.

Building and maintaining documentation pages, help sections, or knowledge bases can be a daunting task. We wanted the canvis.app knowledge base to fit a few criteria: fast and lightweight, search-optimized, affordable to host, portable, branded and well-designed, and most importantly: easy to organize and edit between non-technical team members.

I finally found something that checks all these boxes, was a breeze to build, and didn’t require a single SaaS subscription!

In this tutorial we will create a simple documentation website comprised of a table of contents, sections, and pages.

See the final code here:


See a real airtable/gatsby/markdown/firebase website…

canvis.app — a mapping platform.

Create a shareable collaborative mapping project. For crowd-sourcing, public participation, research and more: https://canvis.app

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store