Documentation

User Stories

3 min read

US01 - Welcome Page(s)

As a new user,
I want to see onboarding screens with features and personalisation questions so that I understand what the platform offers. Acceptance Criteria

  • A visually appealing welcome screen appears on first visit
  • Clearly states the platform’s purpose and benefits
  • Works properly on both desktop and mobile

US02 - Account Signup & Login

As a visitor,
I want to create an account and log in securely,
so that I can save my preferences and access more features. Acceptance Criteria:

  • Users can create accounts with required fields(Only Email for now)

US03 - Map View

As a user,
I want to view companies on a map,
so that I can visually explore local businesses and their capabilities. Acceptance Criteria:

  • Map displays relevant company pins
  • Interactive zoom and pan functions
  • Pins load dynamically based on viewport

US04 - Optional List View

As a user,
I want to switch between map view and list view,
so that I can choose the format that best fits my browsing needs. Acceptance Criteria:

  • Toggle button is clearly visible and functional
  • Map and List views are synchronized
  • Both views have consistent styling and data

US05 - Map Result Filtering

As a user,
I want to filter companies by sector, components, size, capability type, ownership status etc.,
so that I can narrow down the most relevant businesses. Acceptance Criteria:

  • Filters include sector, components, ownership status, etc.
  • Multi-select filters work correctly
  • Filters update map and list views in real time

US06 - Category Icons

As a user,
I want to see company locations with category specific icons on the map,
so that I can quickly distinguish different types of companies at a glance. Acceptance Criteria:

  • Each business category has a meaningful icon
  • Icons display properly at various zoom levels
  • Tooltip or label appears on hover or click

US07 - Company Detail/Profile Page

As a user,
I want to view company profile pages with detailed information,
so that I can understand their offerings, services, and contact information. Acceptance Criteria:

  • Profile contains company name, services, contact, and tags
  • UI layout is clear and consistent
  • Navigation back to map/list view is easy

US08 - Searching

As a user,
I want to search by location or keyword,
so that I can quickly find businesses matching specific terms or regions. Acceptance Criteria:

  • Search bar accepts location or keyword input
  • Autocomplete suggestions appear
  • Results are reflected in both map and list view

Graph View