Pulse · Find Friends
Pulse · Find Friends is a production-ready Social Flutter screen from FlutterKit Pro, installable with flutterkit add social-setup-contacts.
Find Friends is the sixth of eight steps in Pulse's profile-setup flow, built as a single self-contained StatefulWidget with two inline states swapped by a `_granted` flag. A `_SetupHeader` tops the screen with a back IconButton, an eight-segment progress bar that fills the first six segments in indigo #6E56F7, and a '6/8' counter. The initial permission state renders a bold 'Find your friends' title, a reassuring subtitle, and a rounded surface card holding a circular `Icons.contacts_outlined` badge, three `_PermissionPoint` rows (private matching, only-friends-on-Pulse, revoke-in-Settings) each with a muted leading icon, and a filled 'Allow access to contacts' button that calls setState to grant. Tapping it swaps in `_buildList`: a ListView.separated with a green check-circle '3 friends found on Pulse' header followed by `_ContactRow` cards, each pairing a colored `_Monogram` (auto-computed initials over a tinted circle) with the contact's name and @handle or phone number, and a `_PillButton` that toggles between 'Add'/'Added' for members or shows 'Invite' for off-Pulse contacts, tracked in an `_added` Set. A pinned `_SetupFooter` shows 'Not now' before granting and 'Continue' after. Pure Flutter with a bundled Inter font, its own dark near-mono theme (#0B0B0F background, #15151B surfaces), SafeArea, and no network images; it is backend-agnostic, wired through injected onBack and onContinue callbacks so any contacts API or matching service drops in cleanly.
Reveal the one-line command to drop this screen into your project.
Licensed for unlimited commercial projects · resale prohibited · License
What's included
- ✓Dual-state body: contacts-permission explainer and matched-friends list toggled by a single _granted flag with setState
- ✓_SetupHeader with an 8-segment step progress bar (6 filled indigo) plus a 6/8 counter and back IconButton
- ✓_PermissionPoint rows covering private matching, friends-only visibility, and revocable Settings access
- ✓_ContactRow cards using _Monogram initials avatars and _PillButton Add/Added/Invite states backed by an _added Set
- ✓_SetupFooter pinned CTA that reads 'Not now' before grant and 'Continue' after, plus injected onBack/onContinue callbacks
- ✓Bundled Inter font with a self-contained dark theme (#0B0B0F bg, #6E56F7 brand), SafeArea, and no network images
Use cases
- ✓Contacts-permission and friend-discovery step in a new social or chat app's onboarding wizard
- ✓Grow-your-network prompt shown after signup to surface which address-book contacts already joined
- ✓Invite-flow screen letting users add existing members and text-invite contacts who aren't on the app yet
- ✓Reusable privacy-first permission explainer pattern for any feature that needs address-book access
