Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

CW-021 · Two-factor enrolment on mobile

Open
#19 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
65/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
flutter

Research direction

Start in mobile/lib/features/auth/ and trace the existing second-factor code and recovery-code flows, including the settings.security.requireMfa path. Define the enrolment entry point and verify the acceptance cases: a phone-only employee can enrol and sign in, and recovery codes are shown once with a way to save them.

Written by the indexing model from the issue text.

Description

mobile P2 phase-4

Priority P2 · Area mobile · Estimate M · Phase 4

The app can complete a second factor — it shows a code field and accepts a generated or recovery code — but it cannot enrol one. Scanning a QR code with the phone that is displaying it does not work, so an account required to have a second factor is currently told to enrol in the web console first.

That is fine while the requirement only reaches privileged console roles. An organisation that turns on settings.security.requireMfa for everyone leaves its field staff unable to set themselves up from the only device they have.

Scope

Enrolment without a camera round-trip: show the secret, offer a "copy to clipboard" and a deep link that hands the otpauth:// URI straight to an authenticator app on the same device, then confirm with a code.

Acceptance

An employee with no console access can enrol and sign in using only the phone, and the recovery codes are shown once with a way to save them.

Files mobile/lib/features/auth/


Tracked in docs/backlog.md.

Dominant language
TypeScript
Stars
0
Forks
0
Avg merge
37m
Merged PRs (30d)
1

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from SuruchBoss/Cwork

All issues in SuruchBoss/Cwork

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.