Skip to content

0009: MIDOT tool directory

Signed-in Michigan users find the MMEBA and active transportation tools

  • ID: PRD-0009
  • Status: Accepted
  • Decision maker: Trevor Gerhardt
  • Scope: MIDOT
  • Product owner: Trevor Gerhardt
  • Design owner: Trevor Gerhardt
  • Engineering owner: Conveyal
  • Last reviewed: 2026-10-15
  • Related issues or projects: Not applicable. This work follows a direct planning request.
  • Related designs: The legacy MMEBA tools and active transportation tools screens.
  • Related ADRs: ADR 0014
  • Related user documentation: MIDOT guide

Summary

The MIDOT home page lists the MMEBA tools. The active transportation page lists its own tools. Each tool is a card. Available tools link to the tool. Tools that are not ready show "Coming soon". The pages keep the structure of the legacy screens and use Michigan Digital Guidelines components.

User problem and evidence

The MIDOT home page was a component preview. It did not lead to any tool. Signed-in users had to know the property value tool address. The legacy screens group the tools as MMEBA tools and active transportation tools.

Goals and success measures

GoalMeasureTarget or review method
Users reach each available toolBrowser tests of each card linkEvery available card opens its tool
Users can tell which tools are not readyBrowser tests and reviewDisabled cards are not links and say why
The pages are accessibleAutomated WCAG 2.1 A and AANo violations, including at 320 pixels

Non-goals

  • The Aviation, Transit, Events Contribution, and Supply Chain tools.
  • Access decisions for each tool. Every signed-in Michigan user sees the same cards.
  • The teal and gold legacy visual style.

Users and use cases

Use case: Open a tool

  • Actor: A signed-in Michigan TREDIS user.
  • Need: Find and open an MMEBA tool.
  • Goal: Do economic analysis for the Michigan Department of Transportation.

Requirements

PRD-0009-US-01: MMEBA tools

  • Story status: Current
  • Replaces: N/A
  • Replaced by: N/A
  • User need: As a signed-in user, I want the home page to list the MMEBA tools, so that I can open one.
  • Requirement: / shows the heading "MMEBA tools" and cards for TREDIS, Aviation, Transit, and Active transportation.
  • Done when:
    • The TREDIS card opens https://600.tredis.net in a new tab and says so.
    • The Active transportation card opens /active-transportation.
    • The Aviation and Transit cards are disabled.

PRD-0009-US-02: Active transportation tools

  • Story status: Current
  • Replaces: N/A
  • Replaced by: N/A
  • User need: As a signed-in user, I want a page of active transportation tools, so that I can open one.
  • Requirement: /active-transportation shows the heading "Active transportation tools" and cards for Back to MMEBA tools, Events contribution, Supply chain, and Property value.
  • Done when:
    • The Back to MMEBA tools card opens /.
    • The Property value card opens /tools/property-value.
    • The Events contribution and Supply chain cards are disabled.
    • A signed-out visitor goes to sign-in and returns to this page.

PRD-0009-US-03: Return from the property value tool

  • Story status: Current
  • Replaces: N/A
  • Replaced by: N/A
  • User need: As a property value tool user, I want a link back to the active transportation tools, so that I can choose another tool.
  • Requirement: The property value tool shows a "Back to active transportation tools" link above its heading.
  • Done when:
    • The link opens /active-transportation.

PRD-0009-US-04: Disabled tools

  • Story status: Current
  • Replaces: N/A
  • Replaced by: N/A
  • User need: As a user, I want to see which tools are not ready, so that I do not wait for a tool that does nothing.
  • Requirement: A disabled card shows its name, its description, and "Coming soon". It is not a link and cannot receive focus.
  • Done when:
    • Keyboard users skip disabled cards.
    • Screen readers read the "Coming soon" text with the card.

Implementation

The tool directory component renders both pages from a list of tools. The home route and the active transportation route own their lists. The component preview page is removed.

Experience and content

Each page uses the standard MIDOT page with the Michigan header and footer. Cards sit in a grid of four columns, two on medium screens, and one at 320 CSS pixels. Each card shows a Michigan icon in a circle, the tool name as a heading, and a short description.

ToolIconDescription
TREDISchart-lineEconomic forecasts and analysis in TREDIS.
AviationplaneAviation economic tools.
TransitbusTransit economic tools.
Active transportationbicycleProperty value, event, and supply chain tools.
Back to MMEBA toolsarrow-leftReturn to the list of MMEBA tools.
Events contributioneventsEconomic contribution of events.
Supply chaindelivery-truckSupply chain effects.
Property valuebuildingProperty value changes near projects.

Constraints and dependencies

  • PRD 0008 owns sign-in. Every page here requires a session.
  • The TREDIS address is fixed in the home route.

User documentation

  • Audience: Michigan TREDIS users of MIDOT.
  • Tasks to explain: Open a tool from the MMEBA tools page.
  • Agreed terms: MMEBA tools, active transportation tools, and the tool names above.
  • Examples or screenshots needed: The MMEBA tools page.
  • Published documentation: Not applicable until delivery.

Revision history

No revisions.

References