Likepersonsapp
A cross-organizational mobile application for Norwegian disability and patient organizations (NHF, Blindeforbundet, HLF, Barnekreftforeningen) that enables peer mentors (likepersoner) to register activities, manage contacts, submit travel reimbursements, and generate Bufdir reports. The app supports...
Project Summary
Likepersonsapp addresses a critical operational gap across four major Norwegian disability and patient organizations — NHF, Blindeforbundet, HLF, and Barnekreftforeningen — by replacing fragmented paper-based workflows (Word forms, Excel sheets) with a unified, government-compliant mobile platform. The strategic opportunity is significant: peer mentor programs are Bufdir-funded, and automated one-click reporting directly reduces compliance burden and administrative overhead that currently consumes coordinator capacity. By consolidating activity registration, travel reimbursement, and Bufdir report generation into a single WCAG 2.2 AA-compliant mobile app, the organizations reduce operational costs while improving volunteer retention through recognition features like gamification. The multi-tenant architecture means a single platform investment serves all four organizations simultaneously with organization-specific branding and workflows, delivering compounding ROI as adoption scales.
BankID and Vipps authentication alignment with national digital identity infrastructure ensures regulatory trust and low onboarding friction, directly supporting volunteer recruitment and engagement goals.
This is a high-complexity mobile application project serving four distinct client organizations with divergent workflows, terminology, and reporting requirements, all within a single shared codebase. The delivery scope spans 10 functional areas including authentication, activity registration, travel reimbursement, Bufdir report generation, multi-role access control, notifications, gamification, and full WCAG 2.2 AA accessibility compliance. Stakeholder coordination is extensive: each organization (NHF, Blindeforbundet, HLF, Barnekreftforeningen) has unique role structures, approval thresholds, and data sensitivity requirements that must be captured and validated separately. The incremental rollout strategy requires the new app to run in parallel with legacy systems throughout transition — there is no hard cutover — adding regression and compatibility risk to each release.
Key milestones include MLP definition per organization, TestFlight beta distribution to 5–8 users per org, and phased production rollout. Critical risks include BankID/Vipps OAuth integration complexity, encrypted assignment handling for sensitive medical data (epikrise), and accessibility audit gates before each release. Success criteria must include Bufdir report accuracy, WCAG compliance certification, and peer mentor adoption rates.
Likepersonsapp is built on Flutter/Dart targeting iOS and Android from a single codebase, using Supabase as the primary backend for database, authentication, and real-time capabilities. State management combines BLoC for feature-level business logic and Riverpod for dependency injection — the division of responsibility between the two should be explicitly defined early to prevent architectural drift. The system implements organization-scoped multi-tenancy via a dynamic Organization Labels System, Role-Based Access Control (RBAC) with four distinct permission tiers, and StatefulShellRoute tab preservation for a five-tab bottom navigation structure. External integrations include BankID and Vipps OAuth flows (Norwegian eID), Xledger and Microsoft Dynamics for financial data, Cornerstone and Consio for member management, and Bufdir for automated report submission.
Accessibility compliance (WCAG 2.2 AA) is a first-class architectural concern affecting widget design, contrast ratios, screen reader semantics (VoiceOver/JAWS), and font scaling throughout the reusable widget library. Encrypted assignment handling for sensitive medical documents (epikrise) requires careful transport and at-rest encryption implementation. Notable architectural gaps to resolve: offline/caching strategy, BLoC vs Riverpod responsibility boundaries, push notification delivery mechanism, API versioning, and CI/CD pipeline definition.
Features
View all 61 →A pre-login screen that allows users to select which organization they belong to before proceeding with authentication. ...
Standard credential-based authentication allowing users to log in with an email address and password. This is the baseli...
Integration of Norwegian national identity verification (BankID) and Vipps as authentication methods. All four organizat...
After the initial login via email/password or BankID/Vipps, users can authenticate subsequent sessions using device biom...
The app enforces three primary roles — peer mentor (likeperson), coordinator, and organization admin — each with distinc...
A dedicated screen shown when a user's role does not have access to the mobile application — specifically global adminis...
Core activity logging with the absolute minimum number of interaction steps. Peer mentors can record a completed activit...
A per-organisation catalogue of activity types that controls what options appear in the registration wizard. Each organi...
A formalised report form completed after a home visit or one-on-one session, capturing structured fields rather than fre...
Expense logging attached to an activity record, covering kilometre allowance, toll roads, parking, and public transport....
Coordinators can log activities on behalf of one or more peer mentors who are unwilling or unable to use the app themsel...
A per-peer-mentor and per-coordinator summary view showing logged activity over configurable time windows (current month...
A one-tap export that compiles all activity data for a reporting period into the format required by Bufdir (Norwegian Di...
Automatic detection and flagging of likely duplicate activity records before or immediately after submission. A duplicat...
Provides role-specific contact list views for coordinators, org admins, and peer mentors. Each role sees a tailored subs...
Displays full profile information for a contact or peer mentor, including relevant metadata such as affiliation, role, a...
Dedicated detail screen for peer mentors showing their profile, current status (active, paused, expired certification), ...
Allows peer mentors to temporarily deactivate themselves without fully resigning. When paused, the mentor is hidden from...
Supports NHF's requirement where a single member or peer mentor can belong to up to 5 local chapters simultaneously. The...
Basic search functionality across contacts and associated notes, available to all organizations and all roles. Users can...
Allows coordinators to register activities and report on behalf of peer mentors who cannot or will not use the app. This...
Displays peer mentors on an interactive map for geographic matching and assignment planning. Primarily required by Blind...
A structured expense type picker that presents fixed categories — kilometers driven, tolls, parking, and public transit ...
Allows peer mentors to log kilometers driven for an activity, with the app calculating the reimbursement amount based on...
Enables peer mentors to photograph or upload a receipt image directly within the expense entry flow for claims above a c...
Implements a two-path approval model: claims below the auto-approval threshold (distance and/or amount) are marked appro...
Supports Blindeforbundet's specific requirement to register driver fees for peer mentors who transport service recipient...
Provides export of approved expense claims in formats compatible with Xledger (Blindeforbundet) and the Dynamics portal ...
Automatically aggregates all registered peer mentor activities, events, and contact interactions across the reporting pe...
Allows coordinators and organization admins to select the reporting period for which a Bufdir report should be generated...
Presents a structured, human-readable preview of the Bufdir report before it is exported or submitted, showing all aggre...
Maintains a persistent history of all previously generated Bufdir reports within the app, including the period covered, ...
Coordinators can register activities on behalf of peer mentors who are unwilling or unable to use the app directly. This...
Peer mentors can place themselves on a temporary pause — effectively deactivating their availability without fully resig...
A dedicated administrative interface giving organisation-level admins visibility and control over their entire peer ment...
Automates the generation of the activity reports required by Bufdir (the Norwegian Directorate for Children, Youth and F...
Allows coordinators to attach supporting documents to activity records — including invitations, Facebook event screensho...
Tracks the certification status and expiry dates of peer mentors, primarily for HLF where certification is mandatory and...
Provides coordinators with a real-time summary of activity across their peer mentor roster: total activities registered ...
Core push notification infrastructure enabling the app to send timely, role-aware alerts to peer mentors, coordinators, ...
Automatic reminder system that fires when a peer mentor has not recorded any contact with an assigned person within a co...
Automated notification flow for HLF's peer mentor certification lifecycle. The system sends advance warnings (e.g., 60, ...
When a peer mentor activates or deactivates the pause function (temporary deactivation without leaving the programme), t...
Intelligent, context-aware push prompts that surface at relevant moments in the peer mentor workflow — for example, prom...
Dedicated Notifications tab (fifth item in the bottom navigation) presenting a chronological, filterable feed of all sys...
A Spotify Wrapped-inspired yearly summary that presents each peer mentor's contributions in a visually engaging, shareab...
A badge system that awards peer mentors visible recognition for reaching activity milestones, completing training, maint...
Automated half-year and quarterly summary notifications and in-app cards that give peer mentors and coordinators a mid-p...
Intelligent, context-aware push notifications that prompt peer mentors to log activity, check in after a period of inact...
A feature enabling peer mentors to actively recruit new members to their organisation directly from the app. This includ...
An interactive tool that helps peer mentors and prospective volunteers understand the concrete value of their contributi...
Full compatibility with platform screen readers (VoiceOver on iOS, TalkBack on Android) across all app screens and inter...
A design approach that minimises cognitive load for users with acquired brain injuries, intellectual disabilities, or li...
A design token system that enforces WCAG 2.2 AA contrast ratios, accessible type scales, and safe touch-target sizing ac...
A navigation pattern that relies exclusively on explicit tap/button interactions rather than gesture shortcuts, with a p...
An integrated speech-to-text capability that allows peer mentors to dictate free-text report fields instead of typing. T...
A dedicated screen presented at first launch (and when no organization context exists) that lets users select which memb...
Each organization uses different words for the same roles and concepts — what NHF calls a 'koordinator' may differ in la...
Different organizations require different feature sets: travel reimbursement is needed by HLF and Blindeforbundet but no...
The platform must model fundamentally different organizational structures per tenant. NHF has the most complex hierarchy...
Each organization connects to different external systems for accounting and member management: Blindeforbundet uses Xled...