SDK Overview

The VOTR SDK ships a single React Native component, VoteNowButton, that opens a shareholder's hosted ballot inside your app. It is a thin frontend convenience — all the real work (authentication, looking up events, generating the voting URL) happens through the API on your backend.

What the SDK does

• Renders a styleable button in your React Native app.
• Opens the hosted voting URL (returned by the Voting API) in an in-app browser.
• Surfaces lifecycle callbacks — onPress, onSuccess, onError, onBack — so your app can react to the voting flow.

The SDK never sees your client_id / client_secret. It only receives a ready-made voting URL from your backend.

When you need it

The SDK is optional

The SDK is only for in-app voting in React Native. The voting URL your backend generates is a normal link — if you just want to hand shareholders a link (email, web, deep link), you can open it however you like without the SDK.

Your situation	Use the SDK?
React Native app, want voting inside the app	Yes
Web app or you only need to share a link	No — open the voting URL yourself
Backend-only integration (submissions, lookups)	No — that's all API

Where to go next

1. Installation — add the package to your React Native project.
2. SDK Props — the full VoteNowButton props reference.
3. Voting API — how the voting URL the SDK opens is generated.

A complete reference implementation is available at our github repo.