Skip to content

docs(kit-social-login): reflect whitelabel cross-app reality#34

Merged
Agilulfo1820 merged 4 commits into
mainfrom
docs/cross-app-whitelabel-clarification
May 20, 2026
Merged

docs(kit-social-login): reflect whitelabel cross-app reality#34
Agilulfo1820 merged 4 commits into
mainfrom
docs/cross-app-whitelabel-clarification

Conversation

@Agilulfo1820

Copy link
Copy Markdown
Member

Summary

The kit-social-login.md reference doc still framed Privy as required for social login and stated that individual social methods like email, google, passkey, more could not be used without your own Privy credentials. That's been wrong since the v2.7 whitelabel cross-app rollout — the kit now routes Google / Apple / X / Discord / GitHub / TikTok / LINE through VeChain's whitelabel popup automatically when the consuming dApp doesn't pass a privy prop. AI assistants reading this reference were producing outdated guidance.

Changes

  • Section heading: Privy Setup (Required for Social Login)Privy Setup (Optional for Social Login)
  • Spell out which methods work without your own Privy (the cross-app intent set: Google, Apple, X, Discord, GitHub, TikTok, LINE — plus vechain and useLoginWithOAuth().initOAuth(...))
  • Spell out which still require self-hosted Privy (email, passkey, SMS, custom OAuth providers like LinkedIn / Spotify / Instagram)
  • Replace the two-column pros/cons hint with a head-to-head comparison table across cost, setup, branding, login surface, shared identity, security ownership, etc.

Related

Test plan

  • Render the markdown locally and confirm the table renders cleanly
  • Re-run an AI assistant against a "do I need Privy to add Google login?" prompt and verify the answer is "no, unless you need email/passkey/SMS or want no popup"

🤖 Generated with Claude Code

The "you cannot use individual social methods with the free shared
option" claim is no longer accurate. With v2.7+, VeChain Kit routes
Google / Apple / X / Discord / GitHub / TikTok / LINE buttons through
the whitelabel cross-app popup automatically when the consuming dApp
doesn't pass a `privy` prop — they all work without paying Privy.

Restructure the section to:
- Lead with "Privy is OPTIONAL" instead of "Required"
- Spell out exactly which methods work in the no-Privy path (and
  which still need self-hosted Privy: email, passkey, SMS, custom
  OAuth providers)
- Replace the cross-app trade-offs hint with a head-to-head
  comparison table covering cost, setup, branding, login surface,
  shared identity, and security ownership.
@github-actions

github-actions Bot commented May 19, 2026

Copy link
Copy Markdown

Skill Size Report

Skill SKILL.md (always loaded) Ref files (on demand) Total est. tokens Alerts
thor ~1.3K tok 13 files, ~25.3K tok ~26.6K tok
smart-contract-development ~1.1K tok 5 files, ~16.5K tok ~17.6K tok ⚠️ smart-contracts.md ~6.6K tok (consider splitting)
vechain-kit ~1.4K tok 7 files, ~15.2K tok ~16.6K tok
create-vechain-dapp ~1.8K tok 3 files, ~14.2K tok ~16.0K tok ⚠️ monorepo.md ~10.8K tok (consider splitting)
vebetterdao ~1.1K tok 6 files, ~14.8K tok ~15.9K tok
x-2-earn-apps ~1.0K tok 6 files, ~10.3K tok ~11.4K tok
vechain-core ~1.2K tok 4 files, ~8.7K tok ~9.9K tok
vechain-react-native-dev ~1.5K tok 3 files, ~6.7K tok ~8.2K tok
stargate ~736 tok 2 files, ~5.0K tok ~5.7K tok
vebetterdao-navigators ~5.7K tok 0 files, ~0 tok ~5.7K tok ⚠️ SKILL.md ~5.7K tok (always in context)
auto-voting-relayers ~5.5K tok 0 files, ~0 tok ~5.5K tok ⚠️ SKILL.md ~5.5K tok (always in context)
indexer-core ~1.2K tok 5 files, ~3.0K tok ~4.1K tok
secure-github-actions ~1.2K tok 4 files, ~2.9K tok ~4.0K tok
frontend ~1.1K tok 1 files, ~3.0K tok ~4.0K tok
translate ~1.2K tok 0 files, ~0 tok ~1.2K tok
grill-me ~418 tok 0 files, ~0 tok ~418 tok
TOTAL ~152.9K tok
Large reference files (>5.0K tok)
File Est. tokens
create-vechain-dapp/references/monorepo.md ~10.8K
smart-contract-development/references/smart-contracts.md ~6.6K

How to read this: SKILL.md is always loaded into the context window. Reference files are loaded on demand when the topic matches. Token counts are estimates (~4 chars/token). Consider splitting reference files over ~5.0K tokens.

@github-actions

github-actions Bot commented May 19, 2026

Copy link
Copy Markdown

Skill Security Audit

Scanned 75 file(s) — found 14 issue(s) across 5 file(s).

🔵 LOW (14)
File Line Finding Excerpt
skills/thor/references/contributing.md 6 External URL: golangci-lint.run https://golangci-lint.run/usage/install/
skills/thor/references/contributing.md 261 External URL: golang.org https://golang.org/doc/effective_go
skills/x-2-earn-apps/references/getting-started.md 153 External URL: image.png https://image.png
skills/x-2-earn-apps/references/getting-started.md 153 External URL: twitter.com https://twitter.com/tweet/1
skills/x-2-earn-apps/references/security.md 124 External URL: docs.guardianstack.ai https://docs.guardianstack.ai/
skills/x-2-earn-apps/references/sustainability-proofs.md 16 External URL: image.png https://image.png
skills/x-2-earn-apps/references/sustainability-proofs.md 17 External URL: twitter.com https://twitter.com/tweet/1
skills/x-2-earn-apps/references/sustainability-proofs.md 33 External URL: twitter.com https://twitter.com/tweet/123
skills/x-2-earn-apps/references/sustainability-proofs.md 106 External URL: link-to-proof.com https://link-to-proof.com
skills/x-2-earn-apps/references/sustainability-proofs.md 106 External URL: link-to-image.com https://link-to-image.com/1.png
skills/x-2-earn-apps/references/sustainability-proofs.md 192 External URL: link-to-proof.com https://link-to-proof.com
skills/x-2-earn-apps/references/sustainability-proofs.md 192 External URL: link-to-image.com https://link-to-image.com/1.png
skills/x-2-earn-apps/references/sustainability-proofs.md 255 External URL: x.com https://x.com/user/status/123456
skills/x-2-earn-apps/references/vepassport.md 149 External URL: vechain-energy.github.io https://vechain-energy.github.io/vebetterdao-signal-admin/

Markdownlint flagged the bold-on-its-own-line "**Option A: …**" and
"**Option B: …**" lines as emphasis-being-used-as-a-heading. Promote
them to real `###` subsections (and the comparison-table intro line
along with them) so the lint passes and the document outline reflects
the structure properly.
Two updates to the kit-setup skill reference:

- Show `isPrimary: true` in both loginMethods examples, marking the
  recommended CTA (filled inverted surface + green dot) instead of
  relying on a stale "primary CTA — filled, recommended dot" comment
  that implied VeWorld is special. The dev now controls emphasis per
  entry, and the kit falls back to first-visible if none is marked.

- Fix the "Important" callout that listed `google`, `apple`,
  `github`, and `more` as Privy-required. After the cross-app
  whitelabel rollout, only `email`, `passkey`, and `sms` actually
  require self-hosted Privy. The OAuth providers (google/apple/twitter/
  discord/github/tiktok/line) all work via the whitelabel popup, and
  `more` gracefully degrades to whatever's available.

- Add a new "Recommended CTA" note explaining the `isPrimary` flag
  and which buttons currently honor the filled treatment.
@Agilulfo1820 Agilulfo1820 merged commit 79f56e1 into main May 20, 2026
8 checks passed
@Agilulfo1820 Agilulfo1820 deleted the docs/cross-app-whitelabel-clarification branch May 20, 2026 12:25
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