Maple Atlas

Maple Atlas is the public dashboard for MapleScope. It turns Maple Forge exports into a searchable view of Canadian federal grants and contributions.

Current milestone: v0.1.0

Features

• Search by recipient, project, program, department, city, or province
• Filter records by province, department, agreement start date, and minimum value
• Sort all matching records by date or funding value (newest first by default)
• Explore funding totals through an interactive Canadian region map
• Compare funding totals across departments
• Review individual funding agreements and their source data
• Run entirely as a static website with no backend or authentication

By default, Atlas uses Forge's deterministic 500-record development sample, so the dashboard totals describe only that sample. When VITE_DATA_API_URL is configured, Atlas switches to the paginated data service and displays totals and dataset lineage returned by that service.

Setup

Node.js 20 or newer is required.

npm install
npm run dev

Open the local URL printed by Vite.

Commands

npm run dev
npm test
npm run build

Full dataset API

Set VITE_DATA_API_URL at build time to move filtering, aggregation, and pagination out of the browser:

$env:VITE_DATA_API_URL = "https://data.example.ca/v1/"
npm run dev

Atlas sends GET {VITE_DATA_API_URL}/grants with these query parameters:

• query
• province
• department
• start_date
• end_date
• minimum_value
• sort (date_desc, date_asc, value_desc, or value_asc)
• page
• page_size

The response must match GrantQueryResult in src/types.ts. It contains the bounded records page, page metadata, global matching totals, department totals, province and territory totals, filter options, and Forge dataset lineage. Region totals must apply search and department filters while ignoring the selected province so users can move directly between map regions.

Without VITE_DATA_API_URL, Atlas uses the committed 500-record sample through the same client interface. This fallback is intended for tests and local development only.

Updating the data

Forge is the source of truth for the shared grant schema. After building Forge, copy its sample into Atlas. This command expects both repositories to be checked out as sibling directories:

maple/
├── atlas/
└── forge/

Copy-Item ..\forge\data\samples\grants.sample.json public\data\grants.sample.json

Do not hand-edit the copied sample.

Architecture

public/data/         versioned Forge sample
src/data.ts          fallback sample loading and aggregation
src/dataClient.ts    paginated HTTP client and local fallback adapter
src/types.ts         shared Forge and API response shapes
src/App.tsx          asynchronous dashboard and record details
src/styles.css       responsive visual design

Atlas is intentionally client-only for v0.1.0. A database, API, accounts, alerts, and automated claims about recipients are out of scope.

Data source and licence

The data originates from the Government of Canada Proactive Disclosure - Grants and Contributions dataset.

Contains information licensed under the Open Government Licence - Canada.

Project code is licensed under the MIT License.