diff --git a/plugins/tiddlywiki/geospatial/demos.tid b/plugins/tiddlywiki/geospatial/demos.tid
new file mode 100644
index 000000000..1bb2948ba
--- /dev/null
+++ b/plugins/tiddlywiki/geospatial/demos.tid
@@ -0,0 +1,5 @@
+title: $:/plugins/tiddlywiki/geospatial/demos
+
+! Demos
+
+<<tabs tabsList:"[all[tiddlers+shadows]tag[$:/tags/GeospatialDemo]]" default:"$:/plugins/tiddlywiki/geospatial/demo/data">>
diff --git a/plugins/tiddlywiki/geospatial/plugin.info b/plugins/tiddlywiki/geospatial/plugin.info
index 564cf38ed..38af22e72 100644
--- a/plugins/tiddlywiki/geospatial/plugin.info
+++ b/plugins/tiddlywiki/geospatial/plugin.info
@@ -2,5 +2,5 @@
 	"title": "$:/plugins/tiddlywiki/geospatial",
 	"name": "Geospatial Utilities",
 	"description": "Geospatial utilities",
-	"list": "readme settings license"
+	"list": "readme demos settings license"
 }
diff --git a/plugins/tiddlywiki/geospatial/readme.tid b/plugins/tiddlywiki/geospatial/readme.tid
index 1d3221ffa..28a5b63b4 100644
--- a/plugins/tiddlywiki/geospatial/readme.tid
+++ b/plugins/tiddlywiki/geospatial/readme.tid
@@ -1,5 +1,19 @@
 title: $:/plugins/tiddlywiki/geospatial/readme
 
-! Demos
+! Introduction
 
-<<tabs tabsList:"[all[tiddlers+shadows]tag[$:/tags/GeospatialDemo]]" default:"$:/plugins/tiddlywiki/geospatial/demo/data">>
+This is an early alpha build of the new Geospatial Plugin for TiddlyWiki. The goal is to develop new primitives for the TiddlyWiki platform that enable non-developers to build sophisticated interactive geospatial applications.
+
+At this point, the Geospatial Plugin is largely a technical proof of concept of foundational capabilities:
+
+* Integrating the open source [[Leaflet.js|https://leafletjs.com/]] library to display interactive maps
+* Integrating the open source [[Turf.js|https://turfjs.org/]] library to perform geospatial calculations with [[GeoJSON|https://en.wikipedia.org/wiki/GeoJSON]] objects
+* Integrating the commercial API [[TravelTime|https://traveltime.com/]] for [[geocoding|https://traveltime.com/features/geocoding]], [[routing|https://traveltime.com/features/multi-modal-routing]] and [[isochrones|https://traveltime.com/features/isochrones]]
+* Integrating the free API from [[Flickr|https://www.flickr.com/services/api/]] for retrieving geotagged photographs
+* Integrating Google's open source [[OpenLocationCode|https://github.com/google/open-location-code]] library for converting to and from Open Location Codes (also known as [[PlusCodes|https://maps.google.com/pluscodes/]])
+
+!! Limitations
+
+The API keys needed to access external services must be manually configured by the end user. The keys are stored in the browser and so only need to be set up once.
+
+! Getting Started