Documentation

Getting Started with JioBase

Set up a Supabase reverse proxy in under 60 seconds. No infrastructure changes needed.

On this page

What is JioBase?

JioBase is a managed reverse proxy that routes your Supabase API traffic through Cloudflare's global edge network. It was created to solve the ISP-level DNS blocking of *.supabase.co in India, which affects users on Jio, Airtel, ACT Fibernet, and other ISPs.

Instead of your app calling yourproject.supabase.co directly (which is blocked), it calls yourapp.jiobase.com which routes the request through Cloudflare to Supabase transparently.

Your App

Browser / Client

HTTPS

JioBase Proxy

Cloudflare Edge

HTTPS

Supabase

*.supabase.co

Prerequisites

  • An existing Supabase project with a project URL (e.g., https://abcdefgh.supabase.co)
  • Your Supabase anon key (found in Project Settings → API)
  • 60 seconds of your time
1

Create an account

Go to jiobase.com/register and sign up with your email address. No credit card required.

The free tier includes 1 proxy app and 50,000 requests/month, which is enough for most development and small production apps.

2

Create a proxy app

From your dashboard, click "New App" and fill in:

App Name

A friendly label for your project. Example: My SaaS App

Slug

A unique identifier that becomes your proxy subdomain. Example: myapp → myapp.jiobase.com

Supabase Project URL

Your Supabase project URL from the dashboard. Example: https://abcdefgh.supabase.co

Click "Create App" and your proxy will be active immediately.

3

Update your Supabase client

Find where you initialize the Supabase client in your codebase and replace the URL. This is the only change needed. Your anon key and all other configuration stays the same.

Before (blocked on Indian ISPs):

lib/supabase.ts
import { createClient } from '@supabase/supabase-js'
const supabase = createClient(
'https://abcdefgh.supabase.co',
'your-anon-key'
)

After (works everywhere):

lib/supabase.ts
import { createClient } from '@supabase/supabase-js'
const supabase = createClient(
'https://myapp.jiobase.com',// ← changed
'your-anon-key' // ← same key
)

If you use environment variables (recommended), update just the env var:

.env
# Before
SUPABASE_URL=https://abcdefgh.supabase.co
# After
SUPABASE_URL=https://myapp.jiobase.com
# Key stays the same
SUPABASE_ANON_KEY=your-anon-key
4

Deploy and verify

Deploy your updated app. All Supabase API calls - REST queries, authentication, file storage, Realtime subscriptions - will now route through JioBase's Cloudflare proxy.

To verify, test from a Jio or Airtel connection (or use your phone's hotspot). Your app should work without any VPN or DNS changes.

Tip: Check your app's dashboard to see request counts updating in real-time. If requests are flowing through, everything is working.

Framework-specific guides

The integration is the same across all frameworks - just change the URL. Here are examples for popular stacks:

Next.js

lib/supabase.ts
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(
process.env.NEXT_PUBLIC_SUPABASE_URL!,
process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
)
.env.local
NEXT_PUBLIC_SUPABASE_URL=https://myapp.jiobase.com
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

React (Vite)

.env
VITE_SUPABASE_URL=https://myapp.jiobase.com
VITE_SUPABASE_ANON_KEY=your-anon-key

Flutter / Dart

main.dart
await Supabase.initialize(
url: 'https://myapp.jiobase.com',
anonKey: 'your-anon-key',
);

React Native / Expo

lib/supabase.ts
import { createClient } from '@supabase/supabase-js'
const supabase = createClient(
'https://myapp.jiobase.com',
'your-anon-key'
)

Supported features

JioBase proxies the complete Supabase API surface:

REST API (PostgREST)

All CRUD operations, filters, joins, RPC calls

Authentication

Sign up, sign in, OAuth, magic links, password reset

Storage

File uploads, downloads, bucket management, signed URLs

Realtime (WebSockets)

Subscriptions, presence, broadcast channels

Edge Functions

Invoke Deno edge functions through the proxy

GraphQL

pg_graphql queries and mutations

Configuration options

Each proxy app can be configured through the dashboard settings page:

Allowed Origins (CORS)

Control which domains can make cross-origin requests. Set to * for any origin, or specify comma-separated domains like https://myapp.com,https://staging.myapp.com.

Rate Limiting

Set a per-minute request limit to protect your Supabase project. Default is 600 requests/minute. Set to 0 for no limit.

Enabled Services

Choose which Supabase services to proxy. Available: rest, auth, storage, realtime, functions, graphql. All are enabled by default.

App Status

Toggle your app between Active and Inactive. Inactive apps return a 503 error to all requests. Useful for maintenance windows.

Frequently Asked Questions

Does JioBase store my data?
No. JioBase is a transparent pass-through proxy. It forwards requests to Supabase and returns responses without storing, caching, or modifying any data. Your data flows directly between your client and Supabase.
What about latency?
JioBase runs on Cloudflare Workers, which execute at the edge closest to your users (300+ locations globally). The proxy adds 1-5ms of latency - much less than a VPN (50-200ms+) or a DNS change workaround.
Do I need to change my Supabase anon key?
No. Your anon key, service role key, and all other credentials stay exactly the same. The Supabase client library sends them as headers, and JioBase forwards everything unchanged to your Supabase project.
Does Realtime / WebSockets work?
Yes. JioBase detects WebSocket upgrade headers and establishes a bidirectional relay to Supabase Realtime. Subscriptions, presence, and broadcast all work normally through the proxy.
What if the ISP block is lifted?
You can switch back to the direct Supabase URL at any time - just revert your environment variable. However, keeping the proxy in place protects you against future blocks, which are increasingly common in India.
Is JioBase open source?
Yes! JioBase is free and open source. If you find it useful, consider supporting the project.

Self-host your own proxy

Prefer full control? Deploy your own Supabase proxy on Cloudflare Workers for free with our CLI tool. One command scaffolds a production-quality worker and deploys it to your Cloudflare account.

Quick install

$ npx create-jiobase
WebSocket / Realtime support
Service filtering & CORS
Auto-deploy to Cloudflare
100% free (Cloudflare free tier)
Learn more Or use the basic worker generator to manually paste code into Cloudflare.

Need help?

If you run into any issues or have questions, feel free to open an issue on GitHub or check out the blog for detailed technical guides.

Read the blog Support the project