Skip to content

[BUG]: stablepay-sdk README documents an unrelated thirdweb app instead of the actual SDK API #102

@sach2004

Description

@sach2004

Bug Description

The stablepay-sdk/README.md file currently starts as StablePay SDK documentation, but the actual body documents a completely different thirdweb + Supabase application rather than the widget SDK that exists in this repository.

This creates a real integration problem for contributors and consumers because the published package docs do not explain the actual SDK API, configuration shape, widget usage, or supported flows.

Why this is a problem:

  • package consumers get incorrect setup instructions
  • the README does not document Config, NetworkSelector, Widget, or transaction callbacks
  • the docs point users toward unrelated technologies and architecture

Steps to Reproduce

  1. Open stablepay-sdk/README.md
  2. Read the title and opening lines, which suggest this is SDK documentation
  3. Continue reading the body
  4. Observe that the content documents a separate thirdweb/Supabase app, including unrelated stack details, APIs, authentication flow, and app architecture

Logs and Screenshots

No runtime logs apply.

The issue is a documentation mismatch in source control:

  • the README file under stablepay-sdk/ does not match the code and package API in stablepay-sdk/src/

Environment Details

  • Area: stablepay-sdk
  • File: stablepay-sdk/README.md
  • Reproducible from current source checkout on March 27, 2026
  • Affects contributors and integrators reading package documentation

Impact

Low - Minor inconvenience

Code of Conduct

  • I have joined the Discord server and will post updates there
  • I have searched existing issues to avoid duplicates

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions