XPosts setup guide

• GitHub — host the code
• Vercel — deploy the app
• X Developer Portal — API keys
• xAI Console — Grok API key
• cron-job.org — free cron (auto poster)

1. Download and unzip from your dashboard, or fork/clone the repo.
2. Create a new GitHub repository and push the code to your account.

1. Go to vercel.com/new.
2. Import your GitHub repo.
3. Framework: Next.js (auto-detected).
4. Deploy once — it may fail until env vars exist; that's fine.

1. Vercel project → Storage → Create → Blob.
2. Name it (e.g. xgrowth-data) and connect it to the project.
3. Vercel adds BLOB_STORE_ID automatically (OIDC). You usually don't copy it manually.

Vercel → Settings → Environment Variables. Add all of these for Production, Preview, and Development:

Generate secrets

• SESSION_SECRET — long random string (password generator, 32+ chars)
• CRON_SECRET — different long random string
• DASHBOARD_PASSWORD — whatever you want to log in with

Optional (notes only)

CRON_PUBLISH_URL — e.g. https://your-app.vercel.app/api/cron/publish

Deployments → latest → Redeploy (or push a commit). Env vars only apply after redeploy.

1. Go to developer.x.com and open your project (or create one).
2. Click to add a new app — use a name like xposts-auto.

From your new app, open Settings and set permissions to Read and write before generating Access Token + Secret.

You now have every key xposts.co needs for X. Paste them into Vercel → Settings → Environment Variables (Production, Preview, and Development):

Redeploy after saving. Access tokens post as whichever X account generated them — use the account you want to auto-post from.

1. Go to console.x.ai.
2. Create an API key.
3. Add to Vercel as XAI_API_KEY.
4. Redeploy.

Generation costs about $0.01 per text post — you pay xAI directly, not xposts.co.

1. Sign up / log in at cron-job.org.
2. Click Create cronjob → choose URL type.
3. Title: e.g. XPosts publish
4. URL: https://YOUR-APP.vercel.app/api/cron/publish
5. Schedule: every 15 minutes
6. Request method: GET (or POST — both work)

Enable the job and you're done. cron-job.org hits your app every 15 minutes to publish due posts — xposts.co's queue already enforces 15-minute gaps, so posts won't pile up or spam your account.

In cron-job.org, use Test run / Execute now.

Success response (example):

{
  "ok": true,
  "processed": 1,
  "results": [{ "id": "...", "status": "posted", "tweetId": "..." }]
}

1. In Auto poster, schedule a post 20+ minutes ahead.
2. Wait for the next cron run (within 15 min of scheduled time).
3. Refresh Auto poster — status should change to posted.
4. Confirm on X.

Open https://YOUR-APP.vercel.app and enter your DASHBOARD_PASSWORD.

1. Enter your X username (no @).
2. Enter 3 influencer usernames (all unique, no duplicates).
3. Roles: similar niche, aspirational, skill-based (shown in UI).
4. Click Save accounts.
5. Click Build persona — fetches tweets via Bearer Token.
6. Wait until it completes (can take a minute).

• Set up your Growth plan (targets, talking points).
• Pick post format (short / standard / longform).
• Generate posts or run Post ideas (trends + Grok).
• Use Copy or Schedule on any post card.

Rules (built into the app):

• Posts must be scheduled at least 15 minutes apart — the queue won't accept closer intervals.
• Cron checks every 15 minutes, so you won't spam X.
• Max 7 days ahead · max 7 posts/day · max 49 pending in queue.

Ways to schedule

• Schedule on a generated post card (Content hub), or
• Paste text in Auto poster → Add to queue.

• Compare — graph + table vs other tools (local post math).
• Storage — Blob usage; clear history/queue if needed.