# Found8ions - Geographic Intelligence Platform

> AI-friendly documentation for Found8ions. For human visitors, please visit https://getcommonspace.com

## Overview
Found8ions is a geographic intelligence platform that helps organisations visualise, analyse, and communicate complex spatial data with clarity and impact. We specialise in data storytelling and scrollytelling experiences that transform raw geographic data into compelling narratives.

## Platform Architecture

### Core Components
- **Data Library** (`/data-library`): Browse and explore published datasets with interactive maps and charts
- **Data Stories** (`/data-stories`): Scrollytelling experiences that guide users through geographic insights
- **Data Explorer** (`/data-explorer`): Combine multiple datasets on a single interactive map
- **Reports Library** (`/reports`): Research reports and publications

### Data Types Supported
- Choropleth maps (area-based visualizations)
- Heatmaps (density visualizations)
- Point data (markers and clusters)
- Flow maps (origin-destination matrices)
- Isochrones (travel time catchments)
- Real-time feeds (live data from APIs)

## Key Features

### 1. Interactive Map Visualizations
- Multiple map layers with custom styling
- Choropleth coloring with quantile/equal intervals
- Tooltips with configurable properties
- Geographic filtering by boundary type
- Export to PNG, PDF, and data formats

### 2. Scrollytelling / Data Stories
- Scroll-driven map animations
- Narrative chapters with synchronized map states
- Embedded charts and visualizations
- Points of interest (POI) with custom markers

### 3. Temporal Data Support
- Time slider for year-based datasets
- Animation playback for temporal sequences
- Both LONG format (year column) and WIDE format (year columns)

### 4. Geographic Boundary Management
- UK administrative boundaries (LADs, MSOAs, LSOAs, etc.)
- Custom boundary imports from shapefiles/GeoJSON
- Hierarchical boundary relationships

### 5. Transport Infrastructure
- Rail stations with NaPTAN data
- Bus routes from BODS
- Accessibility analysis with isochrones

## API & Data Sources

### Integrated Data Providers
- **NOMIS**: UK Census and labour market statistics
- **BODS**: Bus Open Data Service (real-time)
- **NaPTAN**: National Public Transport Access Nodes
- **OS NGD**: Ordnance Survey National Geographic Database
- **Environment Agency**: Catchment and flood data

### Data Formats Accepted
- CSV with geocoding (postcode, LAD codes, coordinates)
- GeoJSON (FeatureCollection)
- Shapefiles (zipped .shp, .dbf, .prj)
- KML/KMZ
- Excel (.xlsx)

## Multi-Tenant Architecture

Found8ions supports white-label deployments with:
- Custom branding (logo, colors, fonts)
- Custom domains
- Tenant-specific feature toggles
- Data isolation between tenants

## Technical Stack

- **Frontend**: React, TypeScript, Tailwind CSS
- **Maps**: Mapbox GL JS
- **Charts**: Recharts, Nivo
- **Backend**: Supabase (PostgreSQL, Edge Functions, Storage)
- **Auth**: Supabase Auth with role-based access

## Content Discovery

### Public Pages
- `/about` - About Found8ions
- `/features` - Platform features and capabilities
- `/use-cases` - Industry use cases
- `/contact` - Contact form

### Data Content
- `/data-library` - All published datasets
- `/data-library/:id` - Individual dataset detail with maps and charts
- `/data-stories` - All published data stories
- `/data-stories/:id` - Individual story with scrollytelling
- `/reports` - Research reports and publications
- `/news` - Latest updates

### Machine-Readable
- `/sitemap.xml` - XML sitemap (dynamic, includes all published content)
- `/robots.txt` - Crawler directives
- `/llms.txt` - This file

## Structured Data

Found8ions pages include schema.org structured data:
- `Organization` schema on all pages
- `Dataset` schema on dataset detail pages
- `Article` schema on data stories
- `BreadcrumbList` for navigation context
- `SoftwareApplication` on feature pages

## Contact

- **Website**: https://getcommonspace.com
- **Email**: hello@getcommonspace.com
- **Location**: United Kingdom

---

*Last updated: 2026-02-09*