Skip to content

docs: Rewrite Facebook sign-in setup with prerequisites and production steps#668

Open
Zfinix wants to merge 1 commit into
chore/facebook-ui-customization-apifrom
chore/facebook-setup-rewrite
Open

docs: Rewrite Facebook sign-in setup with prerequisites and production steps#668
Zfinix wants to merge 1 commit into
chore/facebook-ui-customization-apifrom
chore/facebook-setup-rewrite

Conversation

@Zfinix

@Zfinix Zfinix commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Problem

The Facebook sign-in setup page had gaps that stopped a developer from getting it working end to end:

  • No prerequisites section, unlike the migrated Google, Apple, and GitHub setup pages.
  • The web flow was missing the Login with the JavaScript SDK toggle. Without it, web sign-in fails at runtime with "JSSDK Option is Not Toggled".
  • No Publishing to production section, so there was no guidance for going live (Live mode, production domains, release key hash, production credentials for self-hosted and Serverpod Cloud).
  • The server-side steps were less explicit than the other providers (no file paths, no migration warning).

Solution

  • Adds a Prerequisites section matching the other providers.
  • Adds the Login with the JavaScript SDK toggle to the portal Settings and Web steps.
  • Rewrites the server-side section to be explicit: file paths, FacebookIdpConfigFromPasswords() as the primary example, and a migration warning.
  • Adds a Publishing to production section covering Live mode, production domains and release key hash, production credentials for self-hosted and Serverpod Cloud, and providing the App ID to the production Flutter build.
  • Slims the duplicated custom-widget example in favor of a pointer to Customizing the UI.
  • Refreshes the portal screenshots and adds captures for the create-app and JavaScript SDK steps.

Stacked on #667 (uses the renamed customizations page). Part of #503 and #507.

@Zfinix Zfinix self-assigned this Jul 2, 2026
@Zfinix Zfinix force-pushed the chore/facebook-ui-customization-api branch from 63f7e7f to 8b09850 Compare July 2, 2026 11:37
@Zfinix Zfinix force-pushed the chore/facebook-setup-rewrite branch from c9c9ec3 to 5ec27ce Compare July 2, 2026 11:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant