@@ -22,32 +22,39 @@ description: Clone, build, and run TablePro locally with Xcode 15+, SwiftLint, a
2222| ** SwiftLint** | Code linting |
2323| ** SwiftFormat** | Code formatting |
2424| ** Homebrew** | Package management |
25+ | ** Git LFS** | Pulls pre-built native libraries from ` Libs/ ` |
2526
2627## Getting Started
2728
28- ### Step 1: Clone the Repository
29+ ### Step 1: Clone and Bootstrap
2930
3031``` bash
3132git clone https://github.com/datlechin/tablepro.git
3233cd tablepro
33- ```
3434
35- ### Step 2: Install Development Tools
35+ # Pull native libraries (stored in Git LFS)
36+ brew install git-lfs
37+ git lfs install
38+ git lfs pull
3639
37- ``` bash
38- # Using Homebrew
40+ # Create required build config (empty is fine for development)
41+ touch Secrets.xcconfig
42+
43+ # Install linting/formatting tools
3944brew install swiftlint swiftformat
4045```
4146
42- ### Step 3: Open in Xcode
47+ <Warning >
48+ Skipping ` git lfs pull ` leaves ` Libs/ ` with pointer files instead of binaries, causing linker errors.
49+ </Warning >
50+
51+ ### Step 2: Open in Xcode
4352
4453``` bash
4554open TablePro.xcodeproj
4655```
4756
48- Or open Xcode manually: ** File** > ** Open** > navigate to ` TablePro.xcodeproj ` .
49-
50- ### Step 4: Build and Run
57+ ### Step 3: Build and Run
5158
52591 . Select the ** TablePro** scheme
53602 . Select ** My Mac** as the destination
@@ -308,13 +315,9 @@ logger.error("Failed to connect: \(error.localizedDescription)")
3083153 . Fix the issue or disable the rule if appropriate
3093164 . Run ` swiftlint --fix ` for auto-fixable issues
310317
311- ### Missing Libraries
312-
313- If native libraries are missing:
318+ ### Missing Libraries or Secrets.xcconfig
314319
315- 1 . Check the ` Libs/ ` directory
316- 2 . Verify ` libmariadb_universal.a ` exists
317- 3 . Run ` scripts/build-release.sh ` to prepare libraries
320+ Run ` git lfs pull ` and ` touch Secrets.xcconfig ` at the repo root. See [ Step 1] ( #step-1-clone-and-bootstrap ) .
318321
319322## Next Steps
320323
0 commit comments