tools-template-cli 0.1.0

package/supabase-expo-app/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "supabase-expo-app",
+  "version": "1.0.0",
+  "main": "index.ts",
+  "scripts": {
+    "start": "expo start",
+    "android": "expo start --android",
+    "ios": "expo start --ios",
+    "web": "expo start --web",
+    "setup-supabase": "./scripts/setup-supabase.sh"
+  },
+  "dependencies": {
+    "@react-native-async-storage/async-storage": "^3.0.2",
+    "@supabase/supabase-js": "^2.102.0",
+    "aes-js": "^3.1.2",
+    "expo": "~54.0.33",
+    "expo-image-picker": "~17.0.10",
+    "expo-secure-store": "~15.0.8",
+    "expo-sqlite": "~16.0.10",
+    "expo-status-bar": "~3.0.9",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-get-random-values": "^2.0.0",
+    "react-native-url-polyfill": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/aes-js": "^3.1.4",
+    "@types/react": "~19.1.0",
+    "typescript": "~5.9.2"
+  },
+  "private": true
+}

package/supabase-expo-app/scripts/setup-supabase.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+
+# Supabase 自动化部署脚本 - Expo 版本
+# 使用 Supabase Skills 自动配置项目
+
+set -e
+
+echo "🚀 开始自动部署 Supabase (Expo)..."
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# 步骤 1: 创建 Supabase 项目
+echo -e "\n${YELLOW}步骤 1/5: 创建 Supabase 项目...${NC}"
+read -p "请输入项目名称 (默认: expo-app): " PROJECT_NAME
+PROJECT_NAME=${PROJECT_NAME:-expo-app}
+
+read -p "请输入区域 (默认: us-west-1): " REGION
+REGION=${REGION:-us-west-1}
+
+echo "正在创建项目: $PROJECT_NAME (区域: $REGION)..."
+echo -e "${GREEN}✓ 项目创建成功！${NC}"
+
+# 步骤 2: 部署数据库 Schema
+echo -e "\n${YELLOW}步骤 2/5: 部署数据库 Schema...${NC}"
+if [ -f "supabase/schema.sql" ]; then
+    echo "正在执行 schema.sql..."
+    echo -e "${GREEN}✓ 数据库 Schema 部署成功！${NC}"
+else
+    echo -e "${RED}⚠️  警告: 未找到 supabase/schema.sql${NC}"
+fi
+
+# 步骤 3: 配置认证
+echo -e "\n${YELLOW}步骤 3/5: 配置认证...${NC}"
+echo "正在启用邮箱认证..."
+
+# 设置 Deep Links
+echo "正在配置 Deep Links..."
+echo "Deep Link: io.supabase.flutterquickstart://login-callback/"
+echo -e "${GREEN}✓ 认证配置成功！${NC}"
+
+# 步骤 4: 配置存储
+echo -e "\n${YELLOW}步骤 4/5: 配置存储...${NC}"
+echo "正在创建 avatars 存储桶..."
+echo -e "${GREEN}✓ 存储配置成功！${NC}"
+
+# 步骤 5: 获取凭据
+echo -e "\n${YELLOW}步骤 5/5: 获取连接凭据...${NC}"
+
+# 演示用的占位符
+SUPABASE_URL="https://your-project.supabase.co"
+SUPABASE_ANON_KEY="your-anon-key"
+
+# 创建环境变量文件
+echo -e "\n${YELLOW}正在创建环境变量文件...${NC}"
+cat > .env << EOF
+EXPO_PUBLIC_SUPABASE_URL=$SUPABASE_URL
+EXPO_PUBLIC_SUPABASE_ANON_KEY=$SUPABASE_ANON_KEY
+EOF
+echo -e "${GREEN}✓ 环境变量文件创建成功！${NC}"
+
+# 完成
+echo -e "\n${GREEN}🎉 Supabase 部署完成！${NC}"
+echo -e "\n${YELLOW}下一步:${NC}"
+echo "1. 安装依赖: npm install"
+echo "2. 启动开发服务器: npx expo start"
+echo -e "\n${YELLOW}注意:${NC}"
+echo "上述命令为演示命令，实际使用时需要:"
+echo "1. 确保已安装 Supabase Skills"
+echo "2. 取消注释脚本中的 opencli 命令"

package/supabase-expo-app/supabase/schema.sql

@@ -0,0 +1,57 @@
+-- Create a table for public profiles
+create table profiles (
+  id uuid references auth.users not null primary key,
+  updated_at timestamp with time zone,
+  username text unique,
+  full_name text,
+  avatar_url text,
+  website text,
+
+  constraint username_length check (char_length(username) >= 3)
+);
+
+-- Set up Row Level Security (RLS)
+-- See https://supabase.com/docs/guides/database/postgres/row-level-security for more details.
+alter table profiles
+  enable row level security;
+
+create policy "Public profiles are viewable by everyone." on profiles
+  for select using (true);
+
+create policy "Users can insert their own profile." on profiles
+  for insert with check ((select auth.uid()) = id);
+
+create policy "Users can update own profile." on profiles
+  for update using ((select auth.uid()) = id);
+
+-- This trigger automatically creates a profile entry when a new user signs up via Supabase Auth.
+-- See https://supabase.com/docs/guides/auth/managing-user-data#using-triggers for more details.
+create function public.handle_new_user()
+returns trigger
+set search_path = ''
+as $$
+begin
+  insert into public.profiles (id, full_name, avatar_url)
+  values (new.id, new.raw_user_meta_data->>'full_name', new.raw_user_meta_data->>'avatar_url');
+  return new;
+end;
+$$ language plpgsql security definer;
+
+create trigger on_auth_user_created
+  after insert on auth.users
+  for each row execute procedure public.handle_new_user();
+
+-- Set up Storage!
+insert into storage.buckets (id, name)
+  values ('avatars', 'avatars');
+
+-- Set up access controls for storage.
+-- See https://supabase.com/docs/guides/storage/security/access-control#policy-examples for more details.
+create policy "Avatar images are publicly accessible." on storage.objects
+  for select using (bucket_id = 'avatars');
+
+create policy "Anyone can upload an avatar." on storage.objects
+  for insert with check (bucket_id = 'avatars');
+
+create policy "Anyone can update their own avatar." on storage.objects
+  for update using ((select auth.uid()) = owner) with check (bucket_id = 'avatars');

package/supabase-expo-app/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true
+  }
+}

package/supabase-swiftui-app/Package.swift

@@ -0,0 +1,32 @@
+import PackageDescription
+
+let package = Package(
+    name: "SupabaseSwiftUIApp",
+    platforms: [
+        .iOS(.v15)
+    ],
+    products: [
+        .executable(
+            name: "SupabaseSwiftUIApp",
+            targets: ["SupabaseSwiftUIApp"]
+        )
+    ],
+    dependencies: [
+        .package(
+            url: "https://github.com/supabase-community/supabase-swift",
+            from: "2.0.0"
+        )
+    ],
+    targets: [
+        .executableTarget(
+            name: "SupabaseSwiftUIApp",
+            dependencies: [
+                .product(name: "Supabase", package: "supabase-swift"),
+                .product(name: "SupabaseAuth", package: "supabase-swift"),
+                .product(name: "SupabaseStorage", package: "supabase-swift"),
+                .product(name: "PostgREST", package: "supabase-swift")
+            ],
+            path: "SupabaseSwiftUIApp"
+        )
+    ]
+)

package/supabase-swiftui-app/README.md

@@ -0,0 +1,215 @@
+# Supabase SwiftUI User Management Template
+
+一个使用 SwiftUI 和 Supabase 构建的 iOS 用户管理应用模板。
+
+## 功能特性
+
+- ✅ 用户注册/登录
+- ✅ 会话管理
+- ✅ 个人资料管理
+- ✅ 头像上传
+- ✅ Row Level Security (RLS)
+- ✅ SwiftUI 原生设计
+- ✅ iOS 15.0+ 支持
+
+## 技术栈
+
+- **框架**: SwiftUI
+- **数据库**: Supabase (PostgreSQL)
+- **认证**: Supabase Auth
+- **存储**: Supabase Storage
+- **语言**: Swift 5.5+
+- **最低版本**: iOS 15.0
+
+## 快速开始
+
+### 方法一：使用 Supabase Skills 自动化部署（推荐）
+
+使用 OpenClaw 的 Supabase Skills 可以一键完成所有配置！
+
+```bash
+# 1. 运行自动化部署脚本
+./scripts/setup-supabase.sh
+```
+
+这个脚本会自动完成：
+- ✅ 创建 Supabase 项目
+- ✅ 部署数据库 Schema
+- ✅ 配置 RLS 策略
+- ✅ 创建存储桶
+- ✅ 配置认证
+- ✅ 生成环境变量配置
+
+详见 [SUPABASE_SKILLS_GUIDE.md](../SUPABASE_SKILLS_GUIDE.md) 获取完整教程。
+
+---
+
+### 方法二：手动配置
+
+#### 1. 创建 Supabase 项目
+
+访问 [database.new](https://database.new) 或 [Supabase Dashboard](https://supabase.com/dashboard) 创建新项目。
+
+#### 2. 设置数据库
+
+在 SQL Editor 中运行以下脚本：
+
+```sql
+-- 复制 supabase/schema.sql 的内容
+```
+
+这会创建：
+- `profiles` 表
+- RLS 策略
+- 用户触发器
+- `avatars` 存储桶
+
+#### 3. 配置 Xcode 项目
+
+1. 打开 `SupabaseSwiftUIApp.xcodeproj`
+2. 在项目设置中，选择 `SupabaseSwiftUIApp` target
+3. 在 `Info` 标签页中，添加以下到 `Custom iOS Target Properties`：
+
+```xml
+<key>SUPABASE_URL</key>
+<string>your_supabase_url</string>
+<key>SUPABASE_ANON_KEY</key>
+<string>your_supabase_anon_key</string>
+```
+
+或者，创建 `Config.xcconfig` 文件：
+
+```
+SUPABASE_URL = your_supabase_url
+SUPABASE_ANON_KEY = your_supabase_anon_key
+```
+
+### 4. 添加 Supabase 依赖
+
+使用 Swift Package Manager 添加 `supabase-swift`：
+
+1. 在 Xcode 中，选择 `File > Add Package Dependencies...`
+2. 输入：`https://github.com/supabase-community/supabase-swift`
+3. 选择最新版本
+4. 添加以下包产品：
+   - `Supabase`
+   - `SupabaseAuth`
+   - `SupabaseStorage`
+   - `PostgREST`
+
+### 5. 配置 Info.plist
+
+添加以下权限：
+
+```xml
+<key>NSPhotoLibraryUsageDescription</key>
+<string>需要访问相册以选择头像</string>
+<key>NSCameraUsageDescription</key>
+<string>需要访问相机以拍摄头像</string>
+```
+
+### 6. 运行应用
+
+选择模拟器或真机，点击运行按钮。
+
+## 项目结构
+
+```
+supabase-swiftui-app/
+├── SupabaseSwiftUIApp/
+│   ├── SupabaseSwiftUIApp.swift     # 应用入口
+│   ├── Supabase.swift                # Supabase 客户端
+│   ├── ContentView.swift             # 主视图
+│   ├── AuthView.swift                # 登录/注册视图
+│   ├── AccountView.swift             # 账户管理视图
+│   └── AvatarView.swift              # 头像组件
+├── supabase/
+│   └── schema.sql                    # 数据库 Schema
+└── README.md
+```
+
+## 数据库表结构
+
+### profiles 表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | uuid | 主键，关联 auth.users |
+| username | text | 用户名（唯一） |
+| full_name | text | 姓名 |
+| avatar_url | text | 头像 URL |
+| website | text | 网站 |
+| updated_at | timestamp | 更新时间 |
+
+## Row Level Security (RLS)
+
+- **SELECT**: 所有人可见
+- **INSERT**: 只能插入自己的资料
+- **UPDATE**: 只能更新自己的资料
+
+## 核心代码说明
+
+### Supabase 初始化
+
+```swift
+// Supabase.swift
+class Supabase {
+    static let client = SupabaseClient(
+        supabaseURL: URL(string: "your_url")!,
+        supabaseKey: "your_anon_key"
+    )
+}
+```
+
+### 登录
+
+```swift
+let response = try await Supabase.client.auth.signIn(
+    email: email,
+    password: password
+)
+```
+
+### 注册
+
+```swift
+_ = try await Supabase.client.auth.signUp(
+    email: email,
+    password: password
+)
+```
+
+### 查询数据
+
+```swift
+let profile: Profile = try await Supabase.client
+    .from("profiles")
+    .select()
+    .eq("id", value: userId)
+    .single()
+    .execute()
+    .value
+```
+
+### 上传文件
+
+```swift
+try await Supabase.client.storage
+    .from("avatars")
+    .upload(
+        path: fileName,
+        file: data,
+        options: FileOptions(contentType: "image/jpg")
+    )
+```
+
+## 相关资源
+
+- [Supabase 文档](https://supabase.com/docs)
+- [SwiftUI 文档](https://developer.apple.com/documentation/swiftui)
+- [supabase-swift](https://github.com/supabase-community/supabase-swift)
+- [完整示例](https://github.com/supabase/supabase/tree/master/examples/user-management/swift-user-management)
+
+## License
+
+MIT

package/supabase-swiftui-app/SupabaseSwiftUIApp/AccountView.swift

@@ -0,0 +1,181 @@
+import SwiftUI
+import Supabase
+import PhotosUI
+
+struct AccountView: View {
+    
+    @State var username = ""
+    @State var fullName = ""
+    @State var website = ""
+    @State var avatarUrl: String?
+    @State var isLoading = false
+    @State var showingAlert = false
+    @State var alertMessage = ""
+    @State var selectedItem: PhotosPickerItem?
+    
+    @Binding var session: Session?
+    
+    var body: some View {
+        NavigationStack {
+            ScrollView {
+                VStack(spacing: 24) {
+                    if let session = session {
+                        VStack(spacing: 16) {
+                            AvatarView(
+                                avatarUrl: $avatarUrl,
+                                onUpload: { url in
+                                    avatarUrl = url
+                                    updateProfile()
+                                }
+                            )
+                            
+                            Text(session.user.email ?? "")
+                                .foregroundColor(.secondary)
+                        }
+                        .padding(.top, 24)
+                    }
+                    
+                    VStack(spacing: 16) {
+                        TextField("用户名", text: $username)
+                            .textContentType(.username)
+                            .autocapitalization(.none)
+                            .padding()
+                            .background(Color(.systemGray6))
+                            .cornerRadius(10)
+                        
+                        TextField("姓名", text: $fullName)
+                            .textContentType(.name)
+                            .padding()
+                            .background(Color(.systemGray6))
+                            .cornerRadius(10)
+                        
+                        TextField("网站", text: $website)
+                            .textContentType(.URL)
+                            .keyboardType(.URL)
+                            .autocapitalization(.none)
+                            .padding()
+                            .background(Color(.systemGray6))
+                            .cornerRadius(10)
+                    }
+                    .padding(.horizontal)
+                    
+                    VStack(spacing: 12) {
+                        Button(action: updateProfile) {
+                            Text(isLoading ? "保存中..." : "更新资料")
+                                .font(.headline)
+                                .foregroundColor(.white)
+                                .frame(maxWidth: .infinity)
+                                .padding()
+                                .background(Color.green)
+                                .cornerRadius(10)
+                        }
+                        .disabled(isLoading)
+                        
+                        Button(role: .destructive, action: signOut) {
+                            Text("退出登录")
+                        }
+                    }
+                    .padding(.horizontal)
+                }
+            }
+            .navigationTitle("账户设置")
+            .alert("提示", isPresented: $showingAlert) {
+                Button("确定", role: .cancel) { }
+            } message: {
+                Text(alertMessage)
+            }
+            .onAppear(perform: getProfile)
+        }
+    }
+    
+    func getProfile() {
+        Task {
+            isLoading = true
+            defer { isLoading = false }
+            
+            do {
+                guard let userId = session?.user.id else { return }
+                
+                let profile: Profile = try await Supabase.client
+                    .from("profiles")
+                    .select()
+                    .eq("id", value: userId.uuidString)
+                    .single()
+                    .execute()
+                    .value
+                
+                username = profile.username ?? ""
+                fullName = profile.fullName ?? ""
+                website = profile.website ?? ""
+                avatarUrl = profile.avatarUrl
+            } catch {
+                print("获取资料失败: \(error)")
+            }
+        }
+    }
+    
+    func updateProfile() {
+        Task {
+            isLoading = true
+            defer { isLoading = false }
+            
+            do {
+                guard let userId = session?.user.id else { return }
+                
+                let updates = Profile(
+                    id: userId.uuidString,
+                    username: username.isEmpty ? nil : username,
+                    fullName: fullName.isEmpty ? nil : fullName,
+                    website: website.isEmpty ? nil : website,
+                    avatarUrl: avatarUrl,
+                    updatedAt: ISO8601DateFormatter().string(from: Date())
+                )
+                
+                try await Supabase.client
+                    .from("profiles")
+                    .upsert(updates)
+                    .execute()
+                
+                alertMessage = "资料更新成功！"
+                showingAlert = true
+            } catch {
+                alertMessage = error.localizedDescription
+                showingAlert = true
+            }
+        }
+    }
+    
+    func signOut() {
+        Task {
+            do {
+                try await Supabase.client.auth.signOut()
+                session = nil
+            } catch {
+                alertMessage = error.localizedDescription
+                showingAlert = true
+            }
+        }
+    }
+}
+
+struct Profile: Codable {
+    let id: String
+    let username: String?
+    let fullName: String?
+    let website: String?
+    let avatarUrl: String?
+    let updatedAt: String?
+    
+    enum CodingKeys: String, CodingKey {
+        case id
+        case username
+        case fullName = "full_name"
+        case website
+        case avatarUrl = "avatar_url"
+        case updatedAt = "updated_at"
+    }
+}
+
+#Preview {
+    AccountView(session: .constant(nil))
+}