Skip to content

Fastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows, iOS testflight! Android, Linux waitlist open! A local Wispr Flow alternative. Follow https://x.com/fluidvoiceapp for more

feat: standardize team ID and add contributor protections - Standardized all DEVELOPMENT_TEAM to V4J43B279J - Added .gitattributes for better pbxproj merge handling - Added pre-commit hook to prevent accidental team ID commits - Updated contributing guidelines with team setup instructions

altic-dev7a807931e126
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..bed1776a
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,5 @@
+# Xcode project files - use custom merge driver for better conflict resolution
+*.pbxproj merge=union
+
+# This helps prevent team ID conflicts by merging non-conflicting changes automatically
+# Contributors should still be careful not to commit team ID changes
diff --git a/README.md b/README.md
index b58b4d30..2d1a409c 100644
--- a/README.md
+++ b/README.md
@@ -84,6 +84,41 @@ Build and run in Xcode. All dependencies are managed via Swift Package Manager.
Contributions are welcome! Please create an issue first to discuss any major changes or feature requests before submitting a pull request.
+### Setting Up Your Development Environment
+
+1. **Clone the repository:**
+ ```bash
+ git clone https://github.com/altic-dev/Fluid-oss.git
+ cd Fluid-oss
+ ```
+
+2. **Open in Xcode:**
+ ```bash
+ open Fluid.xcodeproj
+ ```
+
+3. **Configure your Team ID:**
+ - Select the project in Xcode's navigator
+ - Go to "Signing & Capabilities" tab
+ - Select your Apple Developer Team from the dropdown
+ - Xcode will save this locally in `xcuserdata/` (which is gitignored)
+
+4. **Build and run** - All dependencies are managed via Swift Package Manager
+
+5. **(Optional) Install pre-commit hook** to prevent accidental team ID commits:
+ ```bash
+ cp scripts/check-team-id.sh .git/hooks/pre-commit
+ chmod +x .git/hooks/pre-commit
+ ```
+
+### Pull Request Guidelines
+
+- **Keep changes focused and atomic** - one feature or fix per PR
+- **Update documentation** if adding new features
+- **Test thoroughly** on your machine before submitting
+- **Never commit personal team IDs or API keys** to `project.pbxproj`
+- **Check git diff** before committing to ensure no personal settings leaked in
+
## Connect
Follow development updates on X: [@ALTIC_DEV](https://x.com/ALTIC_DEV)
diff --git a/scripts/check-team-id.sh b/scripts/check-team-id.sh
new file mode 100755
index 00000000..bd56a1de
--- /dev/null
+++ b/scripts/check-team-id.sh
@@ -0,0 +1,29 @@
+#!/bin/bash
+# Pre-commit hook to warn about potential team ID changes
+# To install: cp scripts/check-team-id.sh .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
+
+# Your official team ID
+OFFICIAL_TEAM_ID="V4J43B279J"
+
+# Check if project.pbxproj has been modified
+if git diff --cached --name-only | grep -q "project.pbxproj"; then
+ echo "⚠️ Warning: project.pbxproj is being committed"
+
+ # Check for team ID changes
+ if git diff --cached Fluid.xcodeproj/project.pbxproj | grep -q "DEVELOPMENT_TEAM"; then
+ echo "❌ ERROR: DEVELOPMENT_TEAM changes detected in project.pbxproj"
+ echo ""
+ echo "Team ID changes should NOT be committed."
+ echo "The official team ID is: $OFFICIAL_TEAM_ID"
+ echo ""
+ echo "To fix:"
+ echo " 1. Unstage the file: git reset HEAD Fluid.xcodeproj/project.pbxproj"
+ echo " 2. Discard team ID changes in Xcode"
+ echo " 3. Stage only your intended changes"
+ echo ""
+ echo "To override this check (only if you're sure): git commit --no-verify"
+ exit 1
+ fi
+fi
+
+exit 0