vibeunion/.github

English | 中文

---

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.

The profile/README.md in this repo is auto-rendered on the VibeUnion GitHub organization page.

Contents

• profile/ — Organization profile README (bilingual EN/ZH), auto-rendered on the org homepage
• SKILLS.md — Codex skills installation and usage guide (bilingual EN/ZH)

Start With Your Idea

I want to...	Start here
Build one small app locally without Docker	SupaCloud Lite
Run multiple projects with a web console and production operations	SupaCloud
Add a ready-made admin screen	svadmin
Add users, teams, roles, and permissions	supauth
Add caching, queues, and rate limits without Redis	postgresx
Connect a WeChat mini-program to Supabase	supabase-mp-js

Growth stage	Main question	Add
1. Prove the idea	Can I run one project quickly?	SupaCloud Lite
2. Move to production	Do I need multiple projects and platform operations?	SupaCloud
3. Make it manageable	How do I manage content and users?	svadmin
4. Make it a product	How do teams and permissions work?	supauth
5. Make it reliable	How do caching and background jobs work?	postgresx
6. Reach more users	How do I support WeChat?	supabase-mp-js

What Each Project Does

• SupaCloud Lite is the fast starting point: a Bun-native, single-project, Docker-free Supabase-compatible backend for local development and small deployments.
• SupaCloud is the full self-hosted platform: run multiple isolated projects with a web console, management API, shared PostgreSQL infrastructure, frontend hosting, gateways, and production operations.
• svadmin helps you build screens for managing users, content, orders, settings, and permissions.
• supauth adds hosted login, teams, organizations, roles, invitations, and audit history.
• postgresx provides common app utilities such as cache, counters, background jobs, locks, and events using PostgreSQL.
• supabase-mp-js lets a WeChat mini-program use the same Supabase backend as your web app.

How They Fit Together

You can use one project by itself. A product can grow step by step:

1. Start with SupaCloud Lite when you are validating one project locally or without Docker.
2. Move to SupaCloud when you need multiple projects, a web console, a management API, or production infrastructure.
3. Add svadmin when people need to manage the app.
4. Add supauth when login grows into teams and permissions.
5. Add postgresx when the app needs background work or caching.
6. Add supabase-mp-js when you also want a WeChat mini-program.

In plain language: Lite helps you prove the idea, SupaCloud runs production, supauth manages access, svadmin helps people operate it, postgresx handles background work, and supabase-mp-js brings it to WeChat.

License

MIT

---

中文

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

本仓库的 profile/README.md 会自动渲染到 VibeUnion GitHub 组织主页。

目录

• profile/ — 组织主页 README（中英双语），自动渲染到组织首页
• SKILLS.md — Codex skills 安装与使用指南（中英双语）

先从想法开始

我想做什么	从这里开始
不用 Docker，先在本地快速做出一个应用	SupaCloud Lite
运行多个项目，并拥有控制台和生产运维能力	SupaCloud 标准版
快速做一个后台管理界面	svadmin
增加用户、团队、角色和权限	supauth
不部署 Redis，也想做缓存、队列和限流	postgresx
让微信小程序连接 Supabase	supabase-mp-js

成长阶段	你要解决的问题	添加
1. 先验证想法	能不能快速跑起来一个项目？	SupaCloud Lite
2. 走向生产	是否需要多项目和平台运维？	SupaCloud 标准版
3. 方便管理	如何管理内容和用户？	svadmin
4. 做成产品	团队和权限怎么处理？	supauth
5. 更稳定	缓存和后台任务怎么处理？	postgresx
6. 触达更多用户	如何支持微信？	supabase-mp-js

每个项目做什么

• SupaCloud Lite 是快速起步版本：Bun 原生、单项目、无需 Docker，适合本地开发和小型部署，并兼容 Supabase 常用接口。
• SupaCloud 标准版 是完整的自托管平台：支持多个隔离项目、网页控制台、管理 API、共享 PostgreSQL 基础设施、前端托管、网关和生产运维。
• svadmin 帮你制作用户、内容、订单、设置和权限管理界面。
• supauth 增加托管登录、团队、组织、角色、邀请和操作记录。
• postgresx 使用 PostgreSQL 提供缓存、计数、后台任务、锁和事件等常见能力。
• supabase-mp-js 让微信小程序和网页应用共用同一个 Supabase 后端。

它们如何配合

你可以只使用其中一个项目，也可以逐步增加能力：

1. 想在本地快速验证一个项目，先从 SupaCloud Lite 开始。
2. 需要多项目、控制台、管理 API 或生产基础设施时，迁移到 SupaCloud 标准版。
3. 需要管理应用时，加上 svadmin。
4. 登录发展成团队和权限时，加上 supauth。
5. 需要后台任务或缓存时，加上 postgresx。
6. 需要微信小程序时，加上 supabase-mp-js。

用一句话概括：Lite 帮你验证想法，SupaCloud 标准版承载生产，supauth 管理访问权限，svadmin 帮人管理产品，postgresx 处理后台工作，supabase-mp-js 把产品带到微信。

许可证

MIT