Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/jackiez123430/ideacapture

An experimental iOS app built with SwiftUI + SpriteKit for idea capturing and visualization. 实验性 iOS 应用：基于 SwiftUI + SpriteKit 的灵感捕捉与可视化。
https://github.com/jackiez123430/ideacapture

apple draggesture eventkit idea-capture ios ios-app ios-application ios-swift live-activities mysql php productivity-app spritekit swiftui swiftui-demo xcode

Last synced: about 1 month ago
JSON representation

An experimental iOS app built with SwiftUI + SpriteKit for idea capturing and visualization. 实验性 iOS 应用：基于 SwiftUI + SpriteKit 的灵感捕捉与可视化。

Awesome Lists containing this project

README 

          
# IdeaCapture 想法产生器



> EN: IdeaCapture is an experimental iOS app built with **SwiftUI + SpriteKit**, designed to capture and visualize ideas.  

> CN: IdeaCapture 是一个使用 **SwiftUI + SpriteKit** 构建的实验性 iOS 应用，主要用于灵感捕捉与可视化管理。  



⚠️ **Status**: The project is **abandoned** and no longer maintained. / 本项目 **已弃坑，不再维护**。



---



## ✨ Features / 功能概览



- 📌 **Idea Management / 灵感管理**

  - Create, archive, delete ideas / 创建、归档、删除点子

  - Organize ideas by project / 通过项目组织点子

  - Export `.txt` file of ideas / 导出项目点子为 `.txt`



- 🎨 **Visualization / 可视化**

  - **BubbleCanvas**: SwiftUI random layout with wobble animation  

    **BubbleCanvas**：SwiftUI 随机布局 + 抖动动画  

  - **BubbleScene**: SpriteKit physics bubbles (DVD bounce or Gravity)  

    **BubbleScene**：SpriteKit 物理气泡（DVD 弹跳 / 重力模式）



  


    

    

    

  



- 🔔 **Notifications & Calendar / 通知与日历**

  - Local countdown notifications (24h, 12h, 2h, 1h, 30m, 10m)  

    本地倒计时提醒（24h、12h、2h、1h、30m、10m）  

  - EventKit integration, auto-create calendar events  

    集成 EventKit，自动写入日历



- 🏝️ **Live Activities / 灵动岛**

  - Real-time countdown on Dynamic Island (iOS 16.1+)  

    灵动岛实时倒计时（iOS 16.1+）  

  - Compact / Expanded / Minimal states  

    紧凑 / 展开 / 极简三种状态



- 🚀 **Onboarding / 引导**

  - Multi-step setup wizard with project details  

    多步骤引导页（摘要、标签、目标、受众、语气）  

  - Advanced options: deadline, Live Activity, notifications  

    高级选项：截止日期、灵动岛、通知  



  


    

    

    

    

    

    

  



- ⚙️ **Settings & Developer Mode / 设置与开发者模式**

  - Switch between BubbleCanvas and BubbleScene  

    切换可视化模式（BubbleCanvas / BubbleScene）  

  - Unlock hidden developer mode by tapping version 7 times  

    点击版本号 7 次解锁开发者模式  

  - Debug tools: force onboarding, test notifications, test Live Activity  

    调试工具：重置引导、测试通知、测试灵动岛



---



## 🛠️ Technical Details / 技术实现细节



### 1. Data Layer / 数据层

- **Idea.swift**

  - Stores `id, content, project, createdAt, fontName, fontSize, colorHex, isArchived`

  - 使用 `Codable + UserDefaults` JSON 存储

- **IdeaViewModel**

  - Manages all projects, ideas, configs, and metadata  

  - 调度通知、日历、灵动岛逻辑



---



### 2. Sidebar Gesture / 侧边栏手势

- Implemented in `ContentView.swift` using `DragGesture`  

  在 `ContentView.swift` 中使用 `DragGesture` 实现

- **Rule**:

  - Only if drag starts within left 20px → allow opening sidebar  

  - 只有手势起点在左边 20px 内才允许打开侧边栏  

- **Threshold**:  

  - If drag offset > 40% of sidebar width → open  

  - 向右拖拽超过侧边栏宽度 40% → 打开  



---



### 3. BubbleScene Physics / BubbleScene 物理模拟

- **DVD Mode / DVD 模式**

  - `restitution = 1` → 完全弹性碰撞  

  - `friction = 0` → 无摩擦  

  - Random initial velocity `-100...100`  

    初始速度随机 `-100...100`

- **Gravity Mode / 重力模式**

  - Uses `CoreMotion` accelerometer or device motion  

    使用 `CoreMotion` 加速度计或设备方向  

  - Updates physics world:

    ```swift

    let dx = g.x * gravityStrength

    let dy = g.y * gravityStrength

    physicsWorld.gravity = CGVector(dx: dx, dy: dy)

    ```

  - 实时根据设备姿态改变重力方向



---



### 4. Notifications / 通知参数

- Reminder offsets (in seconds):  

  - `[86400, 43200, 7200, 3600, 1800, 600]`  

  - 对应 **24h, 12h, 2h, 1h, 30m, 10m**  

- Trigger type: `UNTimeIntervalNotificationTrigger`



---



### 5. Live Activity / 灵动岛

- Based on **ActivityKit + WidgetKit**  

- Countdown text formatter:  

  - >1 hour → `"xh ym"`  

  - <1 hour → `"ym"`  

  - expired → `"已到期" / "Expired"`

- Compact → shows short label (e.g., `45m`)  

- Expanded → project name + countdown  



---



## 📂 Project Structure / 项目结构



```

IdeaCapture/

├── IdeaBubbleApp.swift        # App entry / 入口

├── ContentView.swift          # Main UI with Sidebar / 主界面 + 侧边栏

├── BubbleCanvas.swift         # SwiftUI bubble layout / SwiftUI 气泡布局

├── BubbleScene.swift          # SpriteKit bubble physics / SpriteKit 物理气泡

├── AllIdeasView.swift         # Idea list with search / 点子列表 + 搜索

├── ProjectEditorView.swift    # Project editing / 编辑项目

├── ProjectSettingsView.swift  # Project config / 项目配置

├── OnboardingView.swift       # Onboarding wizard / 引导页

├── SettingsView.swift         # Settings + Developer mode / 设置 + 开发者模式

├── Idea.swift                 # Data model + ViewModel / 数据模型 + VM

├── NotificationManager.swift  # Local notifications / 通知

├── CalendarManager.swift      # EventKit integration / 日历

├── LiveActivityManager.swift  # ActivityKit wrapper / 灵动岛封装

├── APIService.swift           # Mock login API / 登录接口

├── NewWidgetExtension/        # Widget + Live Activity extension / 小组件

└── web-backend/               # 后端网站（PHP + MySQL）

```



---



## 🚧 Known Limitations / 已知限制



- Some features only available on iOS 16.1+  

  部分功能仅限 iOS 16.1+  

- 云端上传 / 服务器交互功能未公开 → 功能残缺状态



---



## 🌐 Web Backend / 网站后端



- Located in `/web-backend`  

- Built with **PHP + MySQL**  

- Provides planned API endpoints for:  

  - Idea upload & sync / 点子上传与同步  

  - User login & project binding / 用户登录与项目绑定  



### Database / 数据库

- Database name: `ideaapi_jackiezy`  

- Tables:

  - `projects` → 存放项目基本信息  

  - `project_opinions` → 存放项目意见/反馈  

  - `snapshots` → 存放项目快照  

  - `users` → 存放用户信息（仅示例用户，无真实数据）



### 导入方法

1. 创建数据库：

   ```bash

   CREATE DATABASE ideaapi_jackiezy CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

   ```

2. 导入结构和示例数据：

   ```bash

   mysql -u root -p ideaapi_jackiezy < web-backend/ideaapi_jackiezy.sql

   ```



---



## 📲 Installation / 安装与运行说明



1. 克隆本仓库并在 Xcode 中打开：  

   ```bash

   git clone https://github.com/JackieZ123430/IdeaCapture.git

   cd IdeaCapture

   open IdeaCapture.xcodeproj

   ```



2. **开发环境说明**  

   - 本项目开发于 **Xcode 26 beta 4**  

   - 可以在 **更高版本或正式版 Xcode** 中正常打开与运行  

   - 运行环境要求：**iOS 18 – iOS 26**



3. **功能说明**  

   - 本地功能（点子管理、项目管理、气泡可视化、通知、灵动岛倒计时等）均可正常使用  

   - **部分依赖服务器的功能（云端上传、账号验证等）目前未公开** → 功能不可用，后续可能开放  



4. **开发者模式**  

   - 原本 **双击版本号 7 次** 解锁的云端逻辑已被禁用  

   - 如需使用云端验证账户是否能启动开发者工具，请直接在代码中手动开启：  

     ```swift

     @AppStorage("DebugEnabled") private var debugEnabled: Bool = true

     ```



---



## 📖 Contributing / 贡献



- 本项目已停止维护，**Pull Request 不再主动合并**。  

- 欢迎 fork 本仓库，用于个人学习或扩展功能。  

- 请遵守 [Apache License 2.0](./LICENSE)。



---



## 📝 Changelog / 更新记录



### v1.0.0 (2025-09-09)

- 初始开源版本  

- 包含点子管理、BubbleScene、通知、日历、灵动岛功能  

- 云端上传功能未公开  

- 新增 Web Backend（PHP + MySQL，含数据库结构 `ideaapi_jackiezy`）



---



## 🙏 Acknowledgements / 致谢

- Apple 官方文档（SwiftUI / SpriteKit / ActivityKit / EventKit / UserNotifications）  

- GitHub Actions for iOS CI/CD  

- 参考灵感来自 Things、Notion 等效率应用  



---



## ⚠️ Status / 状态

- EN: This project is **abandoned**, but serves as a reference for SwiftUI + SpriteKit + PHP/MySQL integration.  

- CN: 本项目 **已弃坑**，但可作为 SwiftUI + SpriteKit + PHP/MySQL 集成的参考示例。