Documentation
README
Butterbase Auth Setup
Two umbrella tools cover end-user authentication:
manage_oauth— provider configuration (Google, GitHub, Apple, X, custom)manage_auth_config— auth hooks, JWT lifetimes, service key generation
For broad app build-out, see also butterbase-skills:build-app. This skill is the deep dive.
1. The role model
Every request runs under one of three database roles:
| Auth header | Role | current_user_id() |
RLS |
|---|---|---|---|
| none | butterbase_anon |
NULL | enforced; default deny |
End-user JWT (issued by manage_oauth or email login) |
butterbase_user |
user UUID | enforced |
Service key (bb_sk_*) |
butterbase_service |
NULL | bypassed |
This is the opening of the README. Read the full README on GitHub.