FAQ

Do you see my health data?

No. wristkit is a catalog of files. You copy them into your project and run them on your own infrastructure. We never see your data, your Supabase credentials or your users. The iOS Shortcut posts straight to your own endpoint, and it never touches our servers.

Will this work on the Vercel free tier?

Yes, that is the case wristkit is built for. The ingest endpoint is a serverless function and usually runs in under 50ms per request. The free tier handles a daily sync without breaking a sweat.

Can I use a different database than Supabase?

In v1, not really. The files ship with Drizzle and postgres.js set up for Supabase. If you have a Postgres connection string from somewhere else (Neon, Railway, or a self hosted instance for example), it should work. Proper multi database support is a v2 item.

What about multi user?

Out of scope for v1. The user_id column is in the schema but is nullable and unused. Multi user (per user API keys, RLS in Supabase) is the first item on the v2 list.

Can I use this with Vite or Create React App?

No. wristkit v1 needs Next.js 15 with the App Router. The loadTodayActivity() helper is a Server Component function and leans on Next.js primitives. Vite support is on the v2 list.

How do I change the goals?

loadTodayActivity takes an optional goals parameter. Pass any of kcal, exerciseMinutes and steps:

const state = await loadTodayActivity({
  tz: "America/Sao_Paulo",
  goals: { kcal: 800, exerciseMinutes: 45, steps: 10000 },
});

Defaults are 600 / 30 / 8000.

The Shortcut posted but I see no data

Check the wristkit_samples table in your Supabase dashboard. If you see rows there, the issue is in the query, so double check that WRISTKIT_DATABASE_URL is set and points to the right database, and that loadTodayActivity({ tz }) matches the timezone your sample timestamps live in. If there are no rows, look at your API route logs and look for a 401 or 400 response.

How do I update a component?

There is no CLI. When the files on this site change, copy them again. Each docs page has a copy button on every file. Diff your local version against the new one in your editor.

Is this production ready?

v0.1.0 is an early release. The core (ingest handler, TodayActivityCard and migrations) is solid. Please do not use it for anything health critical. The data is meant for personal tracking and visualization, not for medical decisions.