ScaleDockHQ/better-supabase

ScaleDockHQ のプロフィール

記録された最新のソース活動: 2026年10月24日 12:07

SkillsMP カタログ更新: 2026年10月26日 11:37

収集済み skills: 93

GitHub スター: 2
GitHub フォーク: 0

リポジトリの README

README の元ファイル：README.md

README の元ファイルを読む

README 全文を表示

# better-supabase **Typed repositories, auth glue and a CLI for Supabase apps, APIs, MCP servers and jobs.** [![npm](https://img.shields.io/npm/v/better-supabase)](https://www.npmjs.com/package/better-supabase) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ScaleDockHQ/better-supabase/blob/main/LICENSE) ![TypeScript](https://img.shields.io/badge/TypeScript-6%20%7C%207-3178c6.svg) [Docs](https://bettersupabase.com/docs) · [Quickstart](https://bettersupabase.com/docs/getting-started) · [Blocks](https://bettersupabase.com/docs/blocks) · [Examples](https://bettersupabase.com/docs/examples) · [Changelog](https://bettersupabase.com/changelog) · [GitHub](https://github.com/ScaleDockHQ/better-supabase) better-supabase sits on the supabase-js client you already use. You keep your database, your RLS policies, Supabase Auth and Storage. The CLI reads your schema and generates a typed repository for every table, so a query is a typed object instead of a string. ## Before and after With supabase-js, the query is a string and the error is a Postgres code: ```ts const { data, error } = await supabase .from("customers") .select("id, name") .eq("status", "active") .limit(20); if (error) throw error; ``` With better-supabase, the same read is a typed call on `db`, and the generated hook takes the same arguments: ```ts const customers = await db.customers .list({ select: ["id", "name"], where: { status: "active" }, limit: 20 }) .orThrow(); const rows = useCustomers({ select: ["id", "name"], where: { status: "active" }, limit: 20, }); ``` Each call is still one PostgREST request, and it runs as the signed-in user, so your RLS policies decide what it can read and write. The [supabase-js migration guide](https://bettersupabase.com/docs/migration/supabase-js) maps every supabase-js call to its repository equivalent. ## Install and quick start ```bash pnpm add better-supabase @supabase/supabase-js pnpm add -D pg @supabase/postgrest-typegen@0.6.0 supabase start pnpm better-supabase init # config, src/lib/supabase and framework glue pnpm better-supabase gen # database.types.ts, generated.ts and the data hooks ``` `pg` and `@supabase/postgrest-typegen` are optional peers that only the CLI loads. The package is ESM only. The CLI needs Node 24 or later, and the runtime entries run on every WinterTC runtime. On the server, the adapter gives each request a `db` for the caller. In the browser, `bsb.db` is the same client for the current session: ```ts const { db } = await bsb.context(); const customers = await db.customers .list({ where: { status: "active" }, limit: 20 }) .orThrow(); ``` `gen.hooks` writes `useCustomers` and `useCustomer` next to the generated module. [Data hooks](https://bettersupabase.com/docs/frontend/data-hooks) covers the options. ## Use it where you run An adapter verifies the session, refreshes it in the proxy and gives each handler a `db` for the caller. | Where you run | Docs | | ------------------------------------------------------------------------- | ----------------------------------------------------------------- | | Next.js, Hono, oRPC, Expo Router, SvelteKit, TanStack Start, React Router | [Frameworks](https://bettersupabase.com/docs/frameworks) | | Edge Functions, Node, NestJS, Astro, SolidStart, H3, Nuxt, Elysia | [Frameworks](https://bettersupabase.com/docs/frameworks) | | React, React Native, Vue, Solid, Svelte | [Frontend](https://bettersupabase.com/docs/frontend/client) | | PowerSync and SQLite on the device | [Local data](https://bettersupabase.com/docs/frontend/local-data) | | MCP servers | [MCP](https://bettersupabase.com/docs/frameworks/mcp) | ## The CLI One command per job. `bsb` is the short name. ```bash pnpm better-supabase init # config, client and framework glue pnpm better-supabase gen # types and data hooks pnpm better-supabase gen --check # exit 1 in CI when the schema drifted pnpm better-supabase add queue # a block's SQL into supabase/schemas pnpm better-supabase doctor # RLS, grants, indexes and Supabase advisors pnpm better-supabase skills install # Agent Skills for your coding agent ``` The [CLI reference](https://bettersupabase.com/docs/cli) lists every command and flag. ## Blocks and presets A block is a feature most apps build by hand. `better-supabase add` installs its SQL, and the app calls the instance on `db`. The catalog is grouped by what the block is for: | Category | Catalog | | -------------------------- | ----------------------------------------------------------------------------- | | Organizations and identity | [Organizations](https://bettersupabase.com/docs/blocks/catalog-organizations) | | Database | [Database](https://bettersupabase.com/docs/blocks/catalog-database) | | Collaboration | [Collaboration](https://bettersupabase.com/docs/blocks/catalog-collaboration) | | Work | [Work](https://bettersupabase.com/docs/blocks/catalog-work) | | CRM | [CRM](https://bettersupabase.com/docs/blocks/catalog-crm) | | Commerce | [Commerce](https://bettersupabase.com/docs/blocks/catalog-commerce) | | Content | [Content](https://bettersupabase.com/docs/blocks/catalog-content) | | AI | [AI](https://bettersupabase.com/docs/blocks/catalog-ai) | | Automation | [Automation](https://bettersupabase.com/docs/blocks/catalog-automation) | | Developer | [Developer](https://bettersupabase.com/docs/blocks/catalog-developer) | | Growth | [Growth](https://bettersupabase.com/docs/blocks/catalog-growth) | | People and scheduling | [People](https://bettersupabase.com/docs/blocks/catalog-people) | A [preset](https://bettersupabase.com/docs/presets) installs a set of blocks for a product, such as a CRM, a helpdesk or a CMS. ## Subpaths Each feature is its own entry, so an app only loads what it imports. | Area | Start here | | --------------------------------------- | --------------------------------------------------------------------------- | | Repositories, results and config | [`better-supabase`](https://bettersupabase.com/docs/repository) | | Server, Postgres and auth | [`better-supabase/server`](https://bettersupabase.com/docs/auth/server) | | Framework adapters | [`better-supabase/next`](https://bettersupabase.com/docs/frameworks) | | Browser client and data hooks | [`better-supabase/client`](https://bettersupabase.com/docs/frontend/client) | | Blocks | [`better-supabase/blocks/<name>`](https://bettersupabase.com/docs/blocks) | | APIs (OpenAPI, AsyncAPI, Arazzo) | [`better-supabase/spec`](https://bettersupabase.com/docs/specs) | | AI SDK, Chat SDK, eve, flags, workflows | [Integrations](https://bettersupabase.com/docs/integrations) | | Tests | [`better-supabase/testing`](https://bettersupabase.com/docs/testing) | ## For AI agents The package ships [Agent Skills](https://agentskills.io) for queries, APIs, auth and tests: ```bash npx skills add ScaleDockHQ/better-supabase ``` The docs are also available as [`/llms.txt`](https://bettersupabase.com/llms.txt), as Markdown at `/docs/<page>.md`, and through the read-only docs MCP server at `https://bettersupabase.com/mcp`. See [For AI agents](https://bettersupabase.com/docs/for-ai-agents). ## Documentation The full documentation is at [bettersupabase.com/docs](https://bettersupabase.com/docs). ## License [MIT](https://github.com/ScaleDockHQ/better-supabase/blob/main/LICENSE) © 2026 ScaleDock ## Contributing Setup, the local stack, scripts and the release process are in [`CONTRIBUTING.md`](./CONTRIBUTING.md). The invariants and the "when you change X, also update Y" table for anyone changing the code, human or agent, are in [`AGENTS.md`](./AGENTS.md). Every user-visible change needs a changeset. ## Repository ``` packages/better-supabase/ the library, its CLI and the consumer skills apps/docs/ the documentation site apps/examples/ one app per adapter supabase/ the local stack and the fixture schema ``` `pnpm verify` is the gate before a push. The apps are served with `pnpm dev:portless`. ## Security Report vulnerabilities privately; see [`SECURITY.md`](./SECURITY.md).

リポジトリの README を読み込んでいます…

このリポジトリの skills

分類待ち

skill

職業分類

説明

更新

better-supabase

未分類

Query and write Supabase data with better-supabase's typed repositories, Results and codegen. Use when code imports better-supabase, when adding a table, query or mutation, when a Supabase type is out of date, or after upgrading better-supabase.

原文の言語: 英語

2026-10-24

better-supabase-api

未分類

Build HTTP APIs, Edge Functions and MCP servers on Supabase with better-supabase adapters. Use when adding a route, REST resource, oRPC procedure, Edge Function, MCP tool, AI chat route, knowledge or memory, stored agent, MCP connector, eve agent, Chat SDK…

原文の言語: 英語

2026-10-24

scaledock-repo-standard

未分類

Create a new repo or bring an existing one up to the ScaleDock standard (latest Node supported by Vercel, latest pnpm and TypeScript, Next.js or Expo, Supabase with better-supabase, PermDock, oRPC, MCP, CLI, Fumadocs, Vercel). Use when scaffolding a new…

原文の言語: 英語

2026-10-24

better-supabase-auth

未分類

Read and check the caller in better-supabase apps, including sessions, typed claims, user profiles, OAuth clients and agents acting for a user, scopes, ended sessions and authorization providers. Use when code reads auth, session or claims, when adding a…

原文の言語: 英語

2026-10-23

better-supabase-testing

未分類

Test Supabase RLS policies, APIs and SQL against the local stack with better-supabase/testing, typed seeds and pgTAP. Use when writing or fixing tests that touch the database, policies, auth, OAuth or agent scopes, or Temporal time values.

原文の言語: 英語

2026-10-22

webmcp

未分類

WebMCP: expose web page tools to AI agents via document.modelContext, following the W3C Web Machine Learning Community Group draft (Draft Community Group Report, build posture), and upgrade code from the legacy navigator.modelContext drafts. Use when adding,…

原文の言語: 英語

2026-10-22

ai-gateway

未分類

Vercel AI Gateway guidance for setup, model discovery, authentication, routing, fallbacks, virtual models, evaluation models, BYOK, budgets, spend reporting, observability, compatible APIs, and coding-agent configuration. Use when adding AI Gateway to an app,…

原文の言語: 英語

2026-10-19

env-vars

未分類

Vercel environment variable expert guidance. Use when working with .env files, vercel env commands, Secret or Config variable types, OIDC tokens, or managing environment-specific configuration.

原文の言語: 英語

2026-10-19

flags-sdk

未分類

Implement feature flags in Next.js or SvelteKit code with the Flags SDK (`flags` npm package). Use when installing or configuring the SDK, declaring flags with `flag()`, wiring a provider adapter (`@flags-sdk/vercel`, Statsig, LaunchDarkly, PostHog,…

原文の言語: 英語

2026-10-19

vercel-connect

未分類

Vercel Connect expert guidance for securely obtaining scoped credentials for third-party services on behalf of apps or users. Use when wiring up provider API access, OAuth, API-key services, MCP servers, triggers, framework adapters, eve agent connections, or…

原文の言語: 英語

2026-10-19

vercel-functions

未分類

Vercel Functions expert guidance — Node.js/Bun/Python runtimes, Fluid Compute, long-duration (30 min) functions, large functions (5 GB bundles), Docker/OCI container images, plan limits, streaming, WebSockets, and Cron Jobs. Use when configuring, debugging,…

原文の言語: 英語

2026-10-19

vercel-sandbox

未分類

Vercel Sandbox guidance — ephemeral Firecracker microVMs for running untrusted code safely. Supports AI agents, code generation, and experimentation. Use when executing user-generated or AI-generated code in isolation.

原文の言語: 英語

2026-10-19

vercel-sandbox

未分類

Run untrusted or AI-generated code in ephemeral Firecracker microVMs with @vercel/sandbox. Create a VM, run commands, read/write files, expose ports, snapshot and resume. Use for AI agents, code execution, builds, and isolated experimentation.

原文の言語: 英語

2026-10-19

vercel-services

未分類

Configure and troubleshoot Vercel Services for multiple frontends and backends in one project. Use when composing a polyglot or multi-service application on one Vercel deployment; defining the `services` key, service-targeted rewrites, or service bindings in…

原文の言語: 英語

2026-10-19

reui

未分類

ReUI design and component rules for React apps on shadcn/ui and Tailwind. Use for any UI work in a project with @reui in components.json or a components/reui folder, and in any shadcn project that asks for data grids, kanban boards, dashboards or full pages:…

原文の言語: 英語

2026-10-18

reui

未分類

原文の言語: 英語

2026-10-18

en-301-549

未分類

EN 301 549: apply the European accessibility requirements for ICT products and services, including web, documents and software. Covers EN 301 549 V4.1.1, EN 301 549 V3.2.1 (supported). Use when applying European ICT accessibility requirements. Triggers: EN…

原文の言語: 英語

2026-10-17

section-508

未分類

Section 508: apply the Revised 508 Standards for accessible ICT in US federal agencies. Covers Revised 508 Standards. Use when applying the Revised 508 Standards. Triggers: Section 508.

原文の言語: 英語

2026-10-17

webauthn

未分類

W3C WebAuthn Level 3: build and verify passkey registration and authentication for relying parties, following the § 7.1 and § 7.2 verification steps. Use when adding, reviewing or upgrading passkeys or security keys on a website or server:…

原文の言語: 英語

2026-10-17

ratelimit-headers

未分類

RateLimit headers: advertise HTTP API quotas, handle 429 with the IETF RateLimit and RateLimit-Policy header fields (draft-11 of draft-ietf-httpapi-ratelimit-headers), Retry-After (RFC 9110) and 429 Too Many Requests (RFC 6585). Use when adding rate limiting…

原文の言語: 英語

2026-10-16

scaledock-http-api

未分類

Build or review a ScaleDock HTTP API that follows HTTP Semantics (RFC 9110, RFC 9111), OpenAPI 3.2, JSON Schema 2020-12, OpenAPI Overlay, RFC 9457 Problem Details, the RateLimit header fields and Standard Schema, with PermDock guarding every procedure and…

原文の言語: 英語

2026-10-16

scaledock-mcp-server

未分類

Build or harden a ScaleDock MCP server that follows the MCP base protocol and authorization spec, OAuth 2.1, JWT verification and Problem Details, with PermDock deciding every tool call. Use when adding an MCP surface, protecting MCP tools, wiring Protected…

原文の言語: 英語

2026-10-16

shared-signals

未分類

Shared Signals (SSF, CAEP, RISC): send and receive security events between identity providers, apps and services. Targets the SSF 1.0, CAEP 1.0 and RISC 1.0 Finals, and upgrades peers from the Implementer's Drafts (spec_version 1_0-ID1 to 1_0-ID3); no…

原文の言語: 英語

2026-10-16

spiffe

未分類

SPIFFE: issue and verify workload identities with SPIFFE IDs, X.509-SVIDs, JWT-SVIDs, trust bundles, the Workload API and federation. Use when building or reviewing service-to-service authentication, workload mTLS, workload identity on Kubernetes or VMs, or…

原文の言語: 英語

2026-10-16

standard-schema

未分類

Standard Schema v1: accept any validator via ~standard, and implement or consume the @standard-schema/spec interfaces (StandardSchemaV1, StandardJSONSchemaV1, StandardTypedV1). Covers Standard Schema v1, the only line (package 1.1.0, upgrades from 1.0.0); no…

原文の言語: 英語

2026-10-16

supabase-server

未分類

Use when planning or writing server-side code that uses `@supabase/server` — Edge Functions, Hono apps, webhook handlers, or any backend that creates Supabase clients or validates inbound auth. Trigger **before** writing or modifying any file that imports…

原文の言語: 英語

2026-10-16

a2a

未分類

A2A protocol: publish Agent Cards and talk agent to agent over the Agent2Agent (A2A) 1.0 specification from the Linux Foundation, upgrade 0.3 and 0.2 agents to 1.0, and track the A2A 1.1 preview (task generation and timeline). Use when building or reviewing…

原文の言語: 英語

2026-10-11

ag-ui

未分類

AG-UI: stream agent runs to user-facing apps with the Agent-User Interaction Protocol 1.0, upgrade 0.x integrations to 1.0, and track the AG-UI 1.1 working draft. Use when building or reviewing an AG-UI agent endpoint (producer), a client or UI that consumes…

原文の言語: 英語

2026-10-11

agent-skills

未分類

Agent Skills spec 2026-08-04 (agentskills.io): write, review and validate SKILL.md skills, and load them in an agent. Covers the skill folder layout, the SKILL.md frontmatter (name, description, license, compatibility, metadata, allowed-tools) with its length…

原文の言語: 英語

2026-10-11

agents-md

未分類

AGENTS.md site 2026-03-10 (agents.md): write, place, migrate and review AGENTS.md agent instruction files. The open, unversioned Markdown format for guiding coding agents, stewarded by the Agentic AI Foundation (Linux Foundation). Covers placement (repository…

原文の言語: 英語

2026-10-11

ap2

未分類

AP2 Agent Payments Protocol: authorize AI agent payments with signed Checkout and Payment Mandates (SD-JWT verifiable digital credentials), following AP2 v0.2 (current, draft posture build; no preview). Use when building or reviewing a shopping agent,…

原文の言語: 英語

2026-10-11

asyncapi

未分類

AsyncAPI 3.1: describe event-driven and message-based APIs with servers, channels, operations, messages, protocol bindings and security schemes. Covers AsyncAPI 3.1 (current) and 3.0 (supported), and upgrades from 2.x; no 4.0 preview exists. Use when writing,…

原文の言語: 英語

2026-10-11

authzen

未分類

AuthZEN Authorization API: PEP-to-PDP access evaluation and search over HTTPS JSON. Use when building or reviewing a Policy Enforcement Point (PEP) that asks a Policy Decision Point (PDP) for access decisions, or a PDP that implements the API: the subject,…

原文の言語: 英語

2026-10-11

cedar

未分類

Cedar policy language 4.5: write, validate and evaluate authorization policies with entities, schemas, templates and PARC requests. Targets Cedar 4.x (language 4.5, SDK 4.13.0) and upgrades policies and schemas from Cedar 3.x and 2.x. Use when adding…

原文の言語: 英語

2026-10-11

cloudevents

未分類

CloudEvents 1.0 (1.0.2): describe events in a common format, with context attributes, extensions, the JSON, Avro and Protobuf formats, and the HTTP, Kafka, AMQP, MQTT and NATS bindings, plus upgrades from CloudEvents 0.3. Use when designing event payloads or…

原文の言語: 英語

2026-10-11

commonmark

未分類

CommonMark: parse and render Markdown by the CommonMark specification. Covers CommonMark 0.31.2. Use when parsing CommonMark. Triggers: CommonMark.

原文の言語: 英語

2026-10-11

content-security-policy

未分類

Content Security Policy Level 3: write strict CSP headers, plus the W3C Trusted Types, Permissions Policy and Fetch Metadata Request Headers a server sets and checks to lock down documents. Covers CSP Level 3 (current, Working Draft) with CSP Level 2…

原文の言語: 英語

2026-10-11

conventional-commits

未分類

Conventional Commits: The Conventional Commits specification is a lightweight convention on top of commit messages. Covers Conventional Commits 1.0.0. Use when writing commit messages. Triggers: Conventional Commits.

原文の言語: 英語

2026-10-11

cyclonedx

未分類

CycloneDX 1.7 (ECMA-424 2nd edition) Bill of Materials: produce, validate, sign and consume SBOM, SaaSBOM, HBOM, CBOM, ML-BOM, OBOM, MBOM, VDR and VEX documents in JSON, XML or Protobuf. Use when generating or reviewing a CycloneDX BOM in CI, modelling…

原文の言語: 英語

2026-10-11

diataxis

未分類

Diátaxis: structure documentation into tutorials, how-to guides, reference and explanation. Covers Diátaxis. Use when structuring documentation. Triggers: Diátaxis.

原文の言語: 英語

2026-10-11

収集済み skill 93 件中 40 件を表示しています。

AI アシスタントでインストール

このプロンプトをコピーして、使用中の AI アシスタントに送ってください。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/ScaleDockHQ/better-supabase.