macOS desktop app for posting and scheduling to Facebook Pages and Instagram, with first-comment automation and a real-time comments inbox.
Stack: Tauri v2 (Rust shell) · React 19 + Vite 8 · shadcn/ui (Tailwind v4) · Convex backend (database, scheduling, file storage, Meta Graph API calls).
The app ships with no backend configured — it is not wired to anyone's deployment. On first launch it asks for the Convex deployment it should use, and stores your answer locally on that Mac. To get those URLs you run your own copy of the backend:
npx convex deploy # prints https://<name>.convex.cloudThe HTTP-actions URL is the same deployment name on .convex.site; the setup
screen fills it in for you, and you can override it if yours differs.
You also need your own Meta developer app — this is what posts to
your Pages. Set these on the Convex deployment (dashboard → Settings → Environment
Variables, or npx convex env set):
| Variable | What it is |
|---|---|
META_APP_ID |
Your Meta app's ID |
META_APP_SECRET |
Your Meta app's secret (never leaves the backend) |
META_LOGIN_CONFIG_ID |
Facebook Login for Business configuration ID |
META_WEBHOOK_VERIFY_TOKEN |
Any random string; the same value goes in the Meta webhook setup |
META_GRAPH_VERSION |
Graph API version, e.g. v21.0 |
META_LOGIN_CONFIG_ID |
Optional. Facebook Login for Business configuration ID — only for the legacy flow, see below |
When the Page and the app live in the same business portfolio, Facebook Login for Business cannot be used to grant the Page: its asset picker greys out the portfolio that owns the app ("This Meta Business Account owns the app"), and Meta offers no way to override that. The documented answer for your own portfolio's assets is a business integration system user token.
| Variable | What it is |
|---|---|
META_SYSTEM_USER_TOKEN |
Never-expiring system user token; setting it switches the app into system-user mode |
META_BUSINESS_ID |
Optional. The portfolio whose members may sign in; auto-discovered from the token when omitted |
In Business settings → Users → System users, pick the system user, Add assets → the Page with Full control, then Generate new token for this app with Token expiration: Never and these scopes:
pages_show_list, pages_read_engagement, pages_manage_posts, pages_manage_engagement,
pages_read_user_content, pages_manage_metadata, instagram_basic,
instagram_content_publish, instagram_manage_comments, business_management
npx convex env set META_SYSTEM_USER_TOKEN <token>
In this mode:
- Publishing uses the system user's Page token, stored on the Page (
profiles.pageAccessToken) rather than per manager. It never expires, so there is no 60-day reconnect. - Login requests
public_profileandbusiness_managementonly. No business assets are requested, so the portfolio picker never appears. - Who may sign in is decided by portfolio membership: the app asks the person's own token
which businesses they belong to and refuses anyone outside
META_BUSINESS_ID. Add or remove people in Meta Business settings; there is no separate list in the app.
Leaving META_SYSTEM_USER_TOKEN unset keeps the legacy per-manager login, which requires
META_LOGIN_CONFIG_ID.
| Variable | What it is |
|---|---|
WEBFLOW_SITE_TOKEN |
A Webflow site token with cms:read + cms:write |
Setting it is the whole switch — a Webflow section appears in the composer and
Webflow settings… appears in the avatar menu. Leave it unset and nothing changes.
Note that .env.local is not enough; the backend reads deployment env vars:
npx convex env set WEBFLOW_SITE_TOKEN <token>
Then open Webflow settings…, pick the collection posts are added to, and map its fields onto Name, Post Copy, the Blog Post reference and Link. The blog collection is derived from that reference field and mirrored locally once a day, so the composer's blog picker never spends Webflow API budget. A Webflow failure is reported on the post but never changes whether the social post published.
Then register https://<name>.convex.site/oauth/callback as a valid OAuth redirect
URI in your Meta app, and https://<name>.convex.site/webhooks/meta as the webhook
callback. plans/META.md walks through it.
To point the app somewhere else later: avatar menu → Change Convex deployment….
Requires Node 26 (.nvmrc), Rust (rustup), and Xcode Command Line Tools — see plans/SETUP.md.
npm install
npm run dev:app # convex dev (backend sync) + tauri dev (desktop app)Or in two terminals: npm run dev:convex and npm run tauri dev.
Other scripts: npm run lint, npm run build (frontend only), npm run tauri build (macOS .app/.dmg), npm run seed / npm run seed:clear (dev-only demo posts).
npm run release -- patch # bump, build, verify, tag, publish to GitHub
npm run release -- patch --dry-runscripts/release.sh runs the checks, keeps the version in sync across
package.json / tauri.conf.json / Cargo.toml, builds the .dmg, verifies
the bundle points at prod Convex (and not dev), then tags and publishes a GitHub
release. Full runbook and the manual equivalent: plans/BUILD.md.
The release build runs vite build --mode release, which blanks
VITE_CONVEX_URL and VITE_CONVEX_SITE_URL, so a published .dmg contains no
deployment URL and every download starts at the setup screen. The script fails
the release if one leaks in. A plain npm run build / npm run tauri build still
reads .env.local / .env.production as a convenience for local runs — don't hand
those bundles out. Backend-only changes ship with npx convex deploy and need no
new build.
The bundle is ad-hoc signed (bundle.macOS.signingIdentity: "-") but not
notarized. On a Mac that downloaded it, macOS blocks the first launch: open
System Settings → Privacy & Security, scroll to the blocked-app notice and
click Open Anyway. Or clear the quarantine flag directly:
xattr -dr com.apple.quarantine "/Applications/LevelWell Social.app"Notarizing (an Apple Developer Program membership plus APPLE_ID /
APPLE_PASSWORD / APPLE_TEAM_ID in the build env) is what removes that step.
plans/PLAN.md— architecture and build phasesplans/CONVEX.md— Convex setup and platform factsplans/META.md— Meta developer app setupplans/SETUP.md— macOS dev environmentplans/BUILD.md— build & release runbook