Setup
Get the stack running, register each platform's OAuth app, then connect the accounts you publish from.
http://localhost:30011. Install and run
- 1
Configure the environment
Copy the example file and generate the 32-byte keys used for token encryption and API auth.
cp .env.example .envopenssl rand -hex 32 # ENCRYPTION_KEYopenssl rand -hex 32 # ADMIN_TOKEN - 2
Start Postgres and apply migrations
The database stores accounts, encrypted OAuth tokens, and the scheduler queue.
docker compose up -d postgrescorepack pnpm installcorepack pnpm db:migrate - 3
Run the dashboard and API
With MOCK_MODE=true everything works end to end without any platform credentials.
corepack pnpm dev
2. Register OAuth apps
Each platform needs its own developer app. Register this callback URL, then put the client id and secret in .env.
http://localhost:3001/api/oauth/<platform>/callbackThe redirect is signed with an HMAC state valid for ten minutes, and tokens are stored AES-256-GCM encrypted.
3. Connect accounts
Connect each platform you want to publish to. In mock mode publishing works without connecting anything.
Instagram
Not connected
Publishes a media container to a Business/Creator account. Media is required.
- META_CLIENT_ID
- META_CLIENT_SECRET
- INSTAGRAM_PAGE_ID
Facebook
Not connected
Posts to a Page feed, attaching a single image or video link.
- META_CLIENT_ID
- META_CLIENT_SECRET
- FACEBOOK_PAGE_ID
WhatsApp
Not connected
Sends the text to opted-in recipients through the Cloud API — there is no broadcast post.
- META_CLIENT_ID
- META_CLIENT_SECRET
- WHATSAPP_PHONE_NUMBER_ID
- WHATSAPP_RECIPIENTS
LinkedIn
Not connected
Shares a member ugcPost. Member tokens are refreshed automatically.
- LINKEDIN_CLIENT_ID
- LINKEDIN_CLIENT_SECRET
Substack
Publishing unsupported
Substack exposes no public API for publishing, so this platform is read-only here.
No publishing API Developer docsYouTube
Not connected
Resumable videos.insert upload. Requires exactly one video URL.
- YOUTUBE_CLIENT_ID
- YOUTUBE_CLIENT_SECRET
- YOUTUBE_PRIVACY_STATUS
Snapchat
Publishing unsupported
Snapchat has no public API for publishing organic content, so publishing is unsupported.
No publishing API Developer docsTikTok
Not connected
Pulls one video from a verified domain. Unaudited apps may only post privately.
- TIKTOK_CLIENT_KEY
- TIKTOK_CLIENT_SECRET
- TIKTOK_PRIVACY_LEVEL
Strava
Not connected
Strava has no feed post, so a published draft becomes an activity.
- STRAVA_CLIENT_ID
- STRAVA_CLIENT_SECRET
- STRAVA_SPORT_TYPE