Gathering detailed insights and metrics for @supabase/supabase-js
Gathering detailed insights and metrics for @supabase/supabase-js
An isomorphic Javascript client for Supabase. Query your Supabase database, subscribe to realtime events, upload and download files, browse typescript examples, invoke postgres functions via rpc, invoke supabase edge functions, query pgvector.
Installations
npm install @supabase/supabase-jsDeveloper Guide
BETA
Typescript
Yes
Module System
CommonJS
Node Version
20.19.3
NPM Version
10.8.2
Releases
352
Languages
3
TypeScript
HTML
JavaScript
TypeScript (90.11%)
HTML (5.2%)
JavaScript (4.69%)
Developer
Download Statistics
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
GitHub Statistics
MIT License
3,841 Stars
917 Commits
401 Forks
60 Watchers
19 Branches
158 Contributors
Updated on Jul 18, 2025
Maintainers
14
Package Meta Information
Latest Version
2.52.0
Package Id
@supabase/supabase-js@2.52.0
Unpacked Size
248.82 kB
Size
54.58 kB
File Count
76
NPM Version
10.8.2
Node Version
20.19.3
Published on
Jul 17, 2025
Total Downloads
Cumulative downloads
Total Downloads
NaN
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
6
supabase-js - Isomorphic JavaScript Client for Supabase.
- Documentation: https://supabase.com/docs/reference/javascript/start
- TypeDoc: https://supabase.github.io/supabase-js/v2/
Usage
First of all, you need to install the library:
1npm install @supabase/supabase-js
Then you're able to import the library and establish the connection with the database:
1import { createClient } from '@supabase/supabase-js'
2
3// Create a single supabase client for interacting with your database
4const supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key')UMD
You can use plain <script>s to import supabase-js from CDNs, like:
1<script src="https://cdn.jsdelivr.net/npm/@supabase/supabase-js@2"></script>
or even:
1<script src="https://unpkg.com/@supabase/supabase-js@2"></script>
Then you can use it from a global supabase variable:
1<script> 2 const { createClient } = supabase 3 const _supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key') 4 5 console.log('Supabase Instance: ', _supabase) 6 // ... 7</script>
ESM
You can use <script type="module"> to import supabase-js from CDNs, like:
1<script type="module"> 2 import { createClient } from 'https://cdn.jsdelivr.net/npm/@supabase/supabase-js/+esm' 3 const supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key') 4 5 console.log('Supabase Instance: ', supabase) 6 // ... 7</script>
Deno
You can use supabase-js in the Deno runtime via JSR:
1import { createClient } from 'jsr:@supabase/supabase-js@2'
Custom fetch implementation
supabase-js uses the cross-fetch library to make HTTP requests, but an alternative fetch implementation can be provided as an option. This is most useful in environments where cross-fetch is not compatible, for instance Cloudflare Workers:
1import { createClient } from '@supabase/supabase-js'
2
3// Provide a custom `fetch` implementation as an option
4const supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key', {
5 global: {
6 fetch: (...args) => fetch(...args),
7 },
8})Support Policy
This section outlines the scope of support for various runtime environments in Supabase JavaScript client.
Node.js
We only support Node.js versions that are in Active LTS or Maintenance status as defined by the official Node.js release schedule. This means we support versions that are currently receiving long-term support and critical bug fixes.
When a Node.js version reaches end-of-life and is no longer in Active LTS or Maintenance status, Supabase will drop it in a minor release, and this won't be considered a breaking change.
Deno
We support Deno versions that are currently receiving active development and security updates. We follow the official Deno release schedule and only support versions from the stable and lts release channels.
When a Deno version reaches end-of-life and is no longer receiving security updates, Supabase will drop it in a minor release, and this won't be considered a breaking change.
Important Notes
- Experimental features: Features marked as experimental may be removed or changed without notice
Testing
Unit Testing
1pnpm test
Integration Testing
1supabase start 2pnpm run test:integration
Expo Testing
The project includes Expo integration tests to ensure compatibility with React Native environments.
Next.js Testing
The project includes Next.js integration tests to ensure compatibility with React SSR environments.
Deno Testing
The project includes Deno integration tests to ensure compatibility with Deno runtime.
Bun Testing
The project includes Bun integration tests to ensure compatibility with Bun runtime.
CI/CD Testing
When running on CI, the tests automatically use the latest dependencies from the root project. The CI pipeline:
- Builds the main project with current dependencies
- Creates a package archive (
.tgz) with the latest versions - Uses this archive in Expo, Next.js, and Deno tests to ensure consistency
Local Development
For local development of Expo, Next.js, and Deno tests, you can update dependencies using automated scripts:
1# Update all test dependencies at once 2npm run update:test-deps 3 4# Or update specific test environments: 5npm run update:test-deps:expo # Expo tests only 6npm run update:test-deps:next # Next.js tests only 7npm run update:test-deps:deno # Deno tests only 8npm run update:test-deps:bun # Bun tests only
Note: The CI automatically handles dependency synchronization, so manual updates are only needed for local development and testing.
Badges
No vulnerabilities found.
Reason
30 commit(s) and 3 issue activity found in the last 90 days -- score normalized to 10
Reason
all changesets reviewed
Reason
no dangerous workflow patterns detected
Reason
no binaries found in the repo
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
1 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Reason
dependency not pinned by hash detected -- score normalized to 2
Details
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:52: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:58: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:73: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:91: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:106: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:109: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:114: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:119: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:124: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:158: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:161: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:167: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:192: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:195: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:201: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:207: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:235: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:238: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:244: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:249: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:274: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:277: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:282: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:287: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:312: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:315: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:320: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:326: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/docs.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/docs.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/docs.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/release.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/release.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/supabase/supabase-js/release.yml/master?enable=pin
- Warn: npmCommand not pinned by hash: .github/workflows/ci.yml:221
- Warn: npmCommand not pinned by hash: .github/workflows/ci.yml:261
- Warn: npmCommand not pinned by hash: .github/workflows/ci.yml:339
- Warn: npmCommand not pinned by hash: .github/workflows/ci.yml:141
- Info: 0 out of 26 GitHub-owned GitHubAction dependencies pinned
- Info: 0 out of 11 third-party GitHubAction dependencies pinned
- Info: 6 out of 10 npmCommand dependencies pinned
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yml:25
- Warn: no topLevel permission defined: .github/workflows/ci.yml:1
- Warn: no topLevel permission defined: .github/workflows/docs.yml:1
- Warn: no topLevel permission defined: .github/workflows/release.yml:1
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 30 are checked with a SAST tool
Score
5.9
/10
Last Scanned on 2025-07-07
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More