Overview

Suplex is a Python module that integrates Supabase into the Reflex web framework. It provides a simple state class that manages user authentication, JWT handling, cookie sessions, and database queries — all through subclassing a single Suplex base state.

Rationale

Reflex is a great Python-first web framework, but it doesn’t ship with built-in auth or database integrations. Connecting Supabase requires handling JWTs, refresh tokens, cookie management, and query building manually. Suplex wraps all of this into a clean, inheritable state class so you can focus on building your app instead of wiring up auth plumbing.

Technicals

• Language: Python
• Framework: Reflex (formerly Pynecone)
• Backend: Supabase (PostgreSQL, Auth, Storage)
• Auth: JWT-based with automatic token refresh and cookie session management
• Configuration: Environment variables via .env with rxconfig.py integration
• Distribution: Published on PyPI as suplex

Features

• Supabase authentication (sign up, sign in, sign out)
• JWT token management with auto-refresh
• Cookie-based session persistence
• Database query builder
• Admin queries with service role / secret API key
• Subclass-friendly architecture
• Support for new Supabase API (Oct 2025+)
• Complete query filter set
• Complete query modifier set
• Storage operations

Lessons Learned

Coming soon.

Future

Coming soon.

---

← Back to projects