Continue with Revoked, for Flutter
The official sign-in button and the panel it opens, drawn natively to the same
spec as the web component in
examples/sign-in-button. It runs on Android,
iOS, macOS, Windows, Linux and the web, and uses no Material or Cupertino
widgets, so it fits any design system.
import 'package:revoked_sign_in/revoked_sign_in.dart';
RevokedSignInButton(
start: Uri.parse('https://game.example/auth/revoked/start'),
wait: Uri.parse('https://game.example/auth/revoked/wait'),
onSignedIn: (answer) {
// On the web the session is already a cookie. In an app, `answer`
// carries what the wait route hands over, e.g. answer['session'].
},
)
start and wait are the service's own routes.
Add it to your service says
what they answer. Outside the web they must be absolute URLs.
What happens on a press
- The button calls
startand shows the panel: on a computer the QR code leads and "Open Revoked on this device" is the quiet alternative; on a phone "Open Revoked" leads and the QR code is there for another device. - In a phone app, the Revoked app is opened at once. The panel waits behind it, and asks again the moment the app returns to the foreground.
- The panel asks
waitevery two seconds. On approval it closes andonSignedInreceives the answer. A decline closes it with "Sign-in declined." under the button. An expired sign-in offers "Start again" in the panel.
Outside the web, each wait request carries "client": "app", so the service
can answer with a session in the body instead of a cookie
(Native apps).
Options
| Parameter | Values | Default |
|---|---|---|
label |
continueWith · signIn · signUp · iconOnly |
continueWith |
theme |
black · white · outline · auto |
black |
shape |
rounded · pill |
rounded |
size |
small (36) · medium (44) · large (52) |
medium |
expand |
fill the available width | false |
locale |
en or de; otherwise the app's locale |
— |
onProblem |
told about declined, expired, failed |
— |
httpClient, openApp |
replacements for tests | — |
Black is for light screens, white for dark ones, outline takes the surrounding text colour, and auto follows light and dark mode.
Accessibility
- One semantic button with the visible label as its name; icon-only buttons carry the full label. Enter and Space press it, and it is in the focus order.
- The focus ring is a white band inside a black ring, so it shows on any background. With "increase contrast" the ring and edges are stronger.
- Medium and large meet the 44-point target; on Android the touch area is 48 points around the drawn button, as with Material buttons.
- The button grows with the text size, and long labels wrap.
- "Opening Revoked…" is announced while
startanswers. Problems are written under the button and announced. - The panel is a modal route: focus moves in, Escape and the close button close it, and focus returns to the button. The check code is read out one character at a time, and the QR code has a label.
- The loading animation stands still when the platform asks for less motion.
The tests check Flutter's androidTapTargetGuideline, iOSTapTargetGuideline,
labeledTapTargetGuideline and textContrastGuideline.
Development
flutter test
flutter analyze
License
MPL-2.0. Changes to the files of this package are shared under the same licence; the app that uses it can be under any licence.
Libraries
- revoked_sign_in
- The official "Continue with Revoked" button for Flutter.