VOTR Integration Guide
Welcome to the VOTR developer documentation. This guide walks you through integrating shareholder voting into your React or React Native app using the VOTR API and the VoteNowButton SDK.
Quick start
Four steps from zero to ballot:
- Install the SDK — drop
VoteNowButtoninto your project. - Get an OAuth token — authenticate server-side with client credentials.
- Generate a voting URL — pass account + event details, receive a one-shot URL.
- Render the SDK component — hand the URL to
VoteNowButtonand let it open VOTR's ballot.
How it fits together
The frontend only ever talks to your backend. Your backend holds the OAuth credentials and proxies to VOTR. The user never sees the client secret.
Key features
- Secure by design — OAuth credentials live server-side only; the SDK never sees them.
- Cross-platform — React Native and React applications.
- Minimal configuration — one component, four props.
- Best practices baked in — token caching, retry, deep links, error surfaces.
Environments
| Environment | Base URL |
|---|---|
| Development | https://api-dev.govotr.com |
| Production | https://api.govotr.com |
Next steps
- Prerequisites — security model and what VOTR provides.
- Integration Workflow — the full end-to-end flow.
- Installation — install and wire up the SDK.
- API Integration — interactive playgrounds for every endpoint.
- Sample code on GitHub — reference backend implementation.
- Troubleshooting — common failure modes.