Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tablepro.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Building TablePro

​
Development Builds

​
Xcode

  • Cmd+R to build and run
  • Cmd+B to build only
  • Scheme: TablePro, Destination: My Mac

​
Command Line

xcodebuild -project TablePro.xcodeproj \
    -scheme TablePro \
    -configuration Debug \
    build \
    -skipPackagePluginValidation
Build and run: 
xcodebuild -project TablePro.xcodeproj \
    -scheme TablePro \
    -configuration Debug \
    build \
    -skipPackagePluginValidation && open build/Debug/TablePro.app
-skipPackagePluginValidation is required. CodeEditSourceEditor bundles a SwiftLint plugin that triggers Xcode’s plugin validation on CLI builds.

​
Release Builds

# Apple Silicon
scripts/build-release.sh arm64

# Intel
scripts/build-release.sh x86_64

# Both architectures
scripts/build-release.sh both
Output: 
build/Release/TablePro-arm64.app
build/Release/TablePro-x86_64.app
The build script handles architecture slicing from universal static libraries automatically.

​
Native Libraries

Static .a files (libmariadb, libpq, libfreetds, etc.) are hosted on a GitHub Release (tag libs-v1). They are not in git. 
# Download (skips if already present)
scripts/download-libs.sh

# Force re-download
scripts/download-libs.sh --force

​
Updating Libraries (Maintainers)

When updating a static library: 
# Regenerate checksums
shasum -a 256 Libs/*.a > Libs/checksums.sha256

# Create and upload archive
tar czf /tmp/tablepro-libs-v1.tar.gz -C Libs .
gh release upload libs-v1 /tmp/tablepro-libs-v1.tar.gz --clobber --repo TableProApp/TablePro

# Commit checksum changes
git add Libs/checksums.sha256 && git commit -m "build: update static library checksums"

​
Creating DMG

Build the release first, then package: 
scripts/build-release.sh arm64
scripts/create-dmg.sh arm64
Output: 
build/Release/TablePro-arm64.dmg
build/Release/TablePro-x86_64.dmg

​
Code Signing

​
Development

Unsigned by default. No certificate needed for local testing.

​
Distribution

# Sign
codesign --force --deep --sign "Developer ID Application: Your Name (TEAM_ID)" \
    build/Release/TablePro-arm64.app

# Verify
codesign --verify --verbose build/Release/TablePro-arm64.app

​
Notarization

# Create ZIP
ditto -c -k --keepParent build/Release/TablePro-arm64.app TablePro.zip

# Submit
xcrun notarytool submit TablePro.zip \
    --apple-id "[email protected]" \
    --team-id "TEAM_ID" \
    --password "app-specific-password" \
    --wait

# Staple
xcrun stapler staple build/Release/TablePro-arm64.app

​
Clean Build

MethodCommand
XcodeCmd+Shift+K
CLIxcodebuild -project TablePro.xcodeproj -scheme TablePro clean
Nuclearrm -rf ~/Library/Developer/Xcode/DerivedData

​
CI/CD

​
App Releases

GitHub Actions workflow: .github/workflows/build.yml Triggered by v* tags (e.g., v0.18.0). Pipeline: lint -> build arm64 -> build x86_64 -> release (DMG + ZIP + Sparkle signatures) Release notes are auto-extracted from CHANGELOG.md.

​
Plugin Releases

Workflow: .github/workflows/build-plugin.yml Triggered by plugin-*-v* tags (e.g., plugin-oracle-v1.0.0).
GitHub only fires one workflow per multi-tag push. Push plugin tags individually, or use workflow_dispatch with comma-separated tags for bulk releases.

​
Build Sizes

BuildSize
Debug app~15 MB
Release app~10 MB
DMG (per arch)~3.5 MB