Building an AI Compass for Canadian Nonprofits

17 April 2026#worksona#portfolio#nonprofit-tech#ai-adoption#education#canada

We built a free, no-registration interactive guide that any Canadian nonprofit staff member can open in a browser and start using within minutes. The Okanagan AI Compass is a React/TypeScript single-page application that closes the knowledge gap standing between Canada's 170,000+ nonprofits and practical AI adoption.

The application is self-demonstrating by design. Users read about AI capabilities and immediately exercise them — FAQ answers can be expanded on demand with a live GPT-4 response, and a persistent chat companion trained on nonprofit-specific guidance is available from every page. You learn about AI while using AI.

All editorial content lives in a single TypeScript file (src/data/aiContent.ts) and is completely separated from component code. Adding a new use case, tool, or FAQ entry means appending to a data array — no component changes, no rebuild ceremony.

Why the nonprofit sector needs this

66% of Canadian nonprofits cite lack of understanding as their primary barrier to AI adoption. The tools are often free or deeply discounted for the sector — the problem is not access, it is friction and uncertainty.

Generic AI guides do not address this. They are written for enterprise contexts or for technically literate audiences, and they go stale quickly as PDF documents. The Compass addresses three specific friction points:

Role fragmentation. A program coordinator's concerns differ from a board member's. The Compass provides three distinct adoption pathways (organizational leaders, front-line staff, executives) from a single interface, each framing the same underlying toolset in terms relevant to that role.

Blank-page paralysis. Ten fully documented micro-workflows cover grant writing, donor communications, volunteer management, and board meeting summaries — each with copy-ready prompts, difficulty ratings, and time estimates.

Configuration dropout. The single most common dropout point in AI tool adoption is API key setup. The Compass bundles a default OpenAI key so the AI features work for anyone who opens the page.

How the multi-provider architecture works

The application does not lock to a single AI provider. Users who want to use their organization's own API credentials can configure any of three providers through a settings panel.

// API key resolution chain: localStorage > env vars > bundled default
const resolveApiKey = (provider: Provider): string => {
  return (
    localStorage.getItem(`${provider}_api_key`) ??
    import.meta.env[`VITE_${provider.toUpperCase()}_API_KEY`] ??
    BUNDLED_DEFAULTS[provider]
  );
};

A separate Perplexity integration powers sector-specialized research. Its system prompt grounds responses in Charity Navigator data, giving grant professionals a research tool that can answer "what are the latest funding trends for youth organizations in Canada?" with source-cited, authoritative data rather than generic AI output.

Where it applies

Within the Worksona portfolio, the Compass is the accessibility layer — the entry point that makes the deeper capabilities (knowledge graphs, document analysis, simulation) discoverable and approachable for teams without technical staff.

The stack is React 18 + TypeScript, Vite, shadcn/ui, Tailwind CSS, deployed to Netlify. MIT licensed. No backend required. The entire content surface is editable by non-technical staff through one TypeScript data file.

𝕏 Post