From 7fb42037e9d46e561ddc9934a96031456615c836 Mon Sep 17 00:00:00 2001
From: Ryan Malloy <ryan@supported.systems>
Date: Tue, 6 Jan 2026 12:22:52 -0700
Subject: [PATCH] Initial setup: README and structure for TIGER data dumps

---
 .gitignore |  8 ++++++++
 README.md  | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 64 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..b17be1a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,8 @@
+# Database dumps (stored in releases, not git)
+*.dump
+*.sql.gz
+*.backup
+
+# Temporary files
+*.tmp
+*.log
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..30dc857
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+# TIGER Geocoder Data Dumps
+
+Pre-built PostgreSQL database dumps for the [TIGER/Line Rural Address Geocoder](https://git.supported.systems/mctiger/mctiger).
+
+## Available Dumps
+
+| File | State | Vintage | Size | Description |
+|------|-------|---------|------|-------------|
+| `idaho-tiger-2024.dump` | Idaho (ID) | 2024 | ~297 MB | All 44 counties with edges, featnames, places |
+
+## Quick Start
+
+Instead of downloading and importing raw TIGER/Line shapefiles, restore a pre-built dump:
+
+```bash
+# 1. Download the dump (from releases)
+wget https://git.supported.systems/mctiger/mctiger-data/releases/download/v2024.1/idaho-tiger-2024.dump
+
+# 2. Restore to your PostGIS database
+pg_restore -h localhost -U postgres -d tiger_geocoder idaho-tiger-2024.dump
+```
+
+## What's Included
+
+Each dump contains:
+
+- **tiger_edges** - Road segments with geometries, names, address ranges
+- **tiger_featnames** - Alternate road names and aliases
+- **tiger_places** - City/town boundaries with pre-computed centroids
+- **Indexes** - GiST spatial indexes and GIN trigram indexes (ready to query)
+
+## Creating Your Own Dumps
+
+To create a dump for another state:
+
+```bash
+# 1. Download TIGER/Line data
+tiger-download --state 06  # California
+
+# 2. Import into PostGIS
+tiger-import --state 06
+
+# 3. Create dump
+pg_dump -Fc -h localhost -U postgres tiger_geocoder > california-tiger-2024.dump
+```
+
+## Versioning
+
+Dumps follow the pattern: `{state}-tiger-{year}.dump`
+
+- **Year** matches the TIGER/Line vintage (e.g., 2024)
+- New releases are created when Census Bureau publishes updated data (typically annually)
+
+## License
+
+TIGER/Line data is public domain (US Government work). See [Census Bureau Terms](https://www.census.gov/data/developers/about/terms-of-service.html).