Changelog

Back to Map

Release notes and updates for the F3 Nation Map. Have a feature request or found a bug? Submit it on GitHub.

v3.9.1— Map Updates & Admin Portal Improvements

Map Updates

  • Map now refreshes automatically when you add, edit, or approve workout changes - no manual refresh or revalidation needed

Admin Portal

  • Bug Fix: Higher level admins can again grant access to lower orgs they manage.
  • Feature: User pages now show Home Region
  • Enhancement: Better experience when using the built-in map feature when editing a Location.
  • Enhancement: Social media fields now require http or https in the field. This ensure people enter full URLs and not handles.

API

  • Feature: /docs now displays a sample response for each endpoint, making it easier to understand the data structure and test API calls.
  • Feature: /user/byEmail now returns more information on a user.

v3.8.0— Map Updates & Admin Portal Improvements

Map Updates

  • Map now refreshes automatically when you add, edit, or approve workout changes - no manual refresh or revalidation needed

Admin Portal

  • Upload logos for AOs and Regions - images are automatically scaled and cropped to fit
  • Sidebar now scrolls so you can navigate long menus on smaller screens
  • Event category labels now appear in event type pickers to help you choose the right type
  • Event modal only shows active locations - inactive locations no longer appear in the dropdown
  • Mobile-friendly filter interface - filter tables easily on phones and tablets
  • Improved layout and page titles across all admin pages for better navigation
  • Status dropdown added to Location edit form so you can change Active/Inactive status

API

  • New endpoints for event instances, attendance, and event tags
  • Series exception support for marking series deviations and closures
  • Org chart APIs with role information
  • Improved query parameter handling for number inputs

v3.7.2— Code Login and Location Status

Bug Fixes

  • Login via code was case sensitive - now accepts codes regardless of case
  • Admins could not change Active status of Location in Admin Portal

v3.7.0— Email URL Fix & Minor Improvements

Bug Fixes

  • Fixed map change request email links - View Request button now correctly points to map.f3nation.com instead of api.f3nation.com

Backend

  • Renamed baseUrl to mapBaseUrl in email notification services for clarity

v3.6.7— Map Revalidation Fixes & API Improvements

Bug Fixes

  • Fixed revalidation button in map settings - now properly revalidates map cache when clicked
  • API app revalidation endpoint now triggers map app cache revalidation via HTTP request
  • Map cache updates immediately after database changes without requiring Cloud Build rebuild

API

  • Moved revalidation endpoint from org router to map router for better organization
  • Added position endpoints for SLT (Senior Leadership Team) position management
  • Added source field to webhook data schema to prevent circular loops in external integrations

Backend

  • Created dedicated revalidation endpoint in map app (/api/revalidate) that accepts internal API key authentication
  • API app revalidation now makes HTTP request to map app to ensure both caches are updated
  • Reorganized map router endpoints for better Scalar API documentation grouping

v3.6.5— Map Cache & Deleted Workout Fixes

Bug Fixes

  • Fixed crash when clicking on deleted workouts - deleted AOs/workouts no longer appear on the map
  • Map now automatically updates when workouts or locations are created, updated, or deleted
  • Fixed eventsAndLocations query to exclude inactive locations and locations with no active events

Performance

  • Optimized map data query - switched from LEFT JOIN to INNER JOIN to reduce dataset size
  • Map now only loads locations with active events, reducing initial data transfer and client-side processing

Backend

  • Renamed emitWebhookEvent to notifyMapDataChange to better reflect its dual responsibility of webhook notifications and cache invalidation
  • Added automatic Next.js cache revalidation when map data changes

v3.6.4— API Documentation

API

  • Added endpoint and parameter descriptions to API documentation

v3.6.3— Developer Tooling

Development

  • Added f3-git-workflow skill for consistent branching and merging

v3.6.2— Admin UX & Access Improvements

Admin Portal

  • Manage Access modal now only shows organizations where you are an admin
  • Improved permission denied page - shows clear message and troubleshooting guide
  • Event types now filter by your accessible orgs
  • Better error messages when creating event types or managing roles without required permissions
  • Events without locations now appear in admin event lists

Map Improvements

  • Fixed AM/PM filter toggle - toggling one no longer affects the other
  • Added DeletedWorkoutWarning for handling unavailable events gracefully
  • Optimized map.event endpoints for faster filtering queries

Backend

  • New org.accessible endpoint for getting user's accessible organizations
  • Shared error constants for consistent error messaging
  • Type safety improvements for nullable location handling

v3.5.3— API Enhancements, Webhooks & Admin Tools

New Features

  • Added changelog page - click the version number to view release history
  • Added email template testing page for nation admins at /admin/email-test
  • New dedicated count endpoints for events and organizations
  • Enhanced filtering: filter events by event type name and category

API Improvements

  • Added webhook notification system for map data changes
  • External systems can now be notified when events, locations, or orgs are created, updated, or deleted
  • Improved query parameter handling for array inputs in API endpoints
  • Type-safe email templates with compile-time validation

Backend

  • Created new @acme/mail package for consolidated email functionality
  • Refactored event and org routers for better code organization (DRY)
  • Converted email templates from Handlebars to type-safe TypeScript functions

v3.4.0— Contact Info on Workouts

New Features

  • Contact info now shows on workout cards! If you have a website, email, Twitter (X), Facebook, or Instagram configured for your Region OR AO, all of those links will show up on the info card for your workout
  • FNGs and downrangers can now get in contact with you right from the map
  • Update Region links at map.f3nation.com/admin/regions
  • Update AO links at map.f3nation.com/admin/aos

Notes

  • If you have websites, emails, etc. configured on BOTH an AO and a Region, they will both show up on the card
  • Unless you have a specific contact/link for an AO that is different than the Region link, we recommend leaving the AO fields blank and only configuring them on the Region

v3.3.0— API & Backend Overhaul

Backend

  • F3 now has an API! Create your own read-only API key at map.f3nation.com/admin/api-keys
  • API documentation available at api.f3nation.com/docs
  • Contribute or suggest features on GitHub: github.com/F3-Nation/f3-nation

Changes

  • There are now 2 user pages: All Users and My Users
  • Privacy improvement: You can now only see email and phone numbers for people that are also Admin/Editors in your Region
  • Updated process for creating users and giving admin access to your region

F3 Ecosystem Updates

  • PAXminer (and QSignups and Weaselbot) will be turned off 3/31/26 - please review migration instructions
  • PAX Vault (pax-vault.f3nation.com) is up and running for backblast analytics
  • regions.f3nation.com continues to be a resource - some regions have replaced custom websites with it
  • F3 Near Me temporarily redirects to the map while syncing to the new unified database

v2.2.1— User Search & Admin Improvements

New Features

  • Search Users table by who has permissions - filter by Org (e.g., Region) to see Admin/Editors
  • AO Count column added to Sectors, Areas, and Regions tables in admin portal
  • Filter Locations by Region in /admin/locations

Bug Fixes

  • Regions can now be saved without entering an email address
  • Phone number now shows up correctly in admin portal after saving
  • Region filter by Area and Sector now properly links dropdown options

v2.1.0— AO Websites & Clustering Fixes

New Features

  • AO-specific websites - if both Region and AO have websites, both links will show on the map
  • Admin Portal global sort now applies across all pages, not just the current page
  • Admin Portal changes now show up on the map within seconds (may need to refresh)
  • Filter Requests by 'Only Mine' and 'Pending'
  • Sort by Region on AOs and Events tables

Bug Fixes

  • Improved Location Clustering - all locations are now grouped above a certain zoom level
  • Admins/Editors can now manage Region information (regression fix)
  • Map no longer shows inactive events

v2.0.2— Custom Workout Types

New Features

  • Custom workout types - create your own workout types tied to your region at map.f3nation.com/admin/event-types
  • Assign multiple types to a workout (e.g., an event can be both a Ruck AND a Run)
  • Search results now indicate the Region that event belongs to
  • Inactive filter in Admin Portal Events Page - view and reactivate inactive events
  • Delete Locations via 3-dot menu in Admin Portal

Bug Fixes

  • Event Description now properly populates when editing in Admin Portal