Make AI-generated applications runnable, manageable, and evolvable. / 让 AI 生成的应用可运行、可管理、可演进。

English · 中文

VibeUnion makes practical building blocks for vibecoding: describe what you want to build, let AI help write the code, and add only the pieces your product needs.

You do not need to learn the whole stack before starting. Pick the part you need today and add the rest when your project grows.

SupaCloud comes in two connected editions. SupaCloud Lite is the Bun-native, single-project, Docker-free starting point for local development and small deployments. The full SupaCloud platform is a self-hosted multi-tenant control plane for running isolated projects with a web console, management API, shared PostgreSQL infrastructure, frontend hosting, gateways, and production operations.

Useful when you want to:

• Start locally with SupaCloud Lite and prove one idea without Docker
• Move to the full platform when you need several isolated projects on one server
• Deploy a frontend from GitHub and manage projects from a browser
• Add social login, background jobs, realtime notifications, or automatic scaling later

Think of Lite as the quick prototype runtime and the full platform as the production control plane. Both keep the Supabase-style developer experience while serving different stages of a product's growth.

Svadmin helps you make the screens used to manage an app: user lists, orders, content, settings, reports, and permissions. It works with different backends, so the UI does not lock you into one database or service.

Useful when you want to:

• Turn a database into a usable admin panel quickly
• Add tables, forms, search, filters, import, and export
• Give different staff members different permissions
• Support light/dark mode, multiple languages, and realtime updates

It includes ready-to-use components and hooks, plus adapters for Supabase, REST, GraphQL, Firebase, and other common backends.

Supauth adds the parts of user management that a real product usually needs after basic login: hosted sign-in pages, team or organization accounts, roles, permissions, audit history, and an admin console.

Useful when you want to:

• Let users sign up and sign in without designing every screen yourself
• Support teams, organizations, invitations, and roles
• Give owners and staff a place to manage users and access
• Keep using the normal Supabase Auth behavior underneath

Supauth is an extra layer on top of Supabase Auth. You can start with simple login and add organization features when your product needs them.

Postgresx provides everyday app utilities such as caching, counters, locks, rate limits, queues, and events using PostgreSQL. That means a small project can avoid adding and maintaining a separate Redis service.

Useful when you want to:

• Cache data or count views and requests
• Prevent two jobs from running at the same time
• Limit repeated requests
• Run background jobs and send events between parts of an app
• Keep the first version of your infrastructure small

It supports Bun and Node.js and can also make migration easier for code that already uses Redis-style client methods.

Supabase works well on the web, but WeChat mini-programs use different networking, storage, socket, and file-upload APIs. This package adapts the official Supabase JavaScript client to that environment.

Useful when you want to:

• Build a WeChat mini-program with the same backend as your web app
• Reuse Supabase login, database queries, storage, and realtime features
• Keep the official Supabase API instead of learning a completely different client
• Move between web and WeChat without maintaining two separate data layers

You can use one project by itself. A typical product grows like this:

1. Start with SupaCloud Lite for a local or single-project prototype.
2. Move to the full SupaCloud platform when you need multiple projects, a console, a management API, or production operations.
3. Add svadmin when you need a screen to manage users, content, orders, or settings.
4. Add supauth when simple login grows into teams, roles, invitations, and audit history.
5. Add postgresx when the app needs caching, background jobs, request limits, or event handling.
6. Add supabase-mp-js when the same product needs a WeChat mini-program.

In plain language:

Lite helps prove the idea, the full SupaCloud platform runs production, supauth manages who can use it, svadmin helps people operate it, postgresx handles common behind-the-scenes work, and supabase-mp-js brings it to WeChat.

We publish Codex skills to help AI agents work with these projects. See our skills guide for installation and usage.

VibeUnion 为 vibecoding 提供实用的开源积木：你先说清楚想做什么，再让 AI 帮你写代码，用一组简单、可复用的工具，把想法逐步做成真正能用的产品。

你不需要一开始就学完整套技术栈。今天需要什么，就先用什么；项目变大以后，再按需要添加其他能力。

SupaCloud 有两个相互衔接的版本。SupaCloud Lite 是 Bun 原生、单项目、无需 Docker 的快速起步版本，适合本地开发和小型部署；完整的 SupaCloud 标准版 是自托管的多租户控制平面，提供隔离项目、网页控制台、管理 API、共享 PostgreSQL 基础设施、前端托管、网关和生产运维能力。

适合这些场景：

• 想先用 SupaCloud Lite 在本地快速验证一个想法，不安装 Docker
• 需要在一台服务器上运行多个隔离项目，再迁移到完整平台
• 想从 GitHub 部署前端，并通过浏览器管理项目
• 以后可能需要社交登录、后台任务、实时通知或自动扩缩容

可以把 Lite 理解成快速验证用的运行时，把标准版理解成生产环境的控制平面。两者都保留 Supabase 风格的开发体验，但服务于产品成长的不同阶段。

Svadmin 用来快速制作管理应用的界面，例如用户列表、订单、内容、设置、报表和权限管理。它可以连接不同后端，不会把你的界面锁死在某一种数据库或服务上。

适合这些场景：

• 想快速把数据库变成能用的管理后台
• 需要表格、表单、搜索、筛选、导入和导出
• 需要给不同工作人员分配不同权限
• 需要中英文、暗色模式或实时更新

它提供现成的界面组件和开发工具，也支持 Supabase、REST、GraphQL、Firebase 等常见后端。

Supauth 处理真实产品在基础登录之外经常需要的功能：托管登录页、团队或组织账号、角色、权限、操作记录和管理后台。

适合这些场景：

• 不想自己从零设计注册和登录页面
• 需要团队、组织、邀请和角色
• 需要让管理员管理用户和访问权限
• 仍然希望继续使用标准 Supabase Auth

Supauth 是 Supabase Auth 上面的增强层。你可以先做简单登录，产品真的需要团队和组织功能时再加上它。

Postgresx 使用 PostgreSQL 提供缓存、计数、锁、限流、队列和事件等常见能力。这样，小项目不必一开始就额外部署和维护 Redis。

适合这些场景：

• 缓存数据，或统计访问量和请求量
• 防止同一个后台任务被重复执行
• 限制短时间内的重复请求
• 执行后台任务，并在应用之间传递事件
• 希望第一版基础设施尽量简单

它支持 Bun 和 Node.js，也能帮助已经使用 Redis 风格方法的项目逐步迁移。

Supabase 在网页端很好用，但微信小程序有自己的网络、存储、Socket 和文件上传接口。这个项目把官方 Supabase JavaScript 客户端适配到微信小程序环境。

适合这些场景：

• 想让微信小程序和网页使用同一个后端
• 想复用 Supabase 登录、数据库查询、存储和实时能力
• 不想重新学习一套完全不同的客户端 API
• 想让网页端和微信端共享同一套数据逻辑

你可以只使用其中一个项目。一个产品通常可以这样逐步成长：

1. 本地或单项目原型先使用 SupaCloud Lite。
2. 需要多项目、控制台、管理 API 或生产运维时，迁移到完整的 SupaCloud 标准版。
3. 需要管理用户、内容、订单或设置时，加上 svadmin。
4. 简单登录发展成团队、角色、邀请和操作记录时，加上 supauth。
5. 需要缓存、后台任务、请求限制或事件处理时，加上 postgresx。
6. 需要微信小程序时，加上 supabase-mp-js。

用一句话概括：

Lite 帮你验证想法，SupaCloud 标准版承载生产，supauth 管理谁能使用，svadmin 帮人管理产品，postgresx 处理后台杂务，supabase-mp-js 把产品带到微信。

我们发布了 Codex skills，帮助 AI Agent 更好地使用这些项目。安装与使用请参考 skills 指南。

_{Built with intent. / 以意图驱动。}