Development Setup

Prerequisites

Software	Version	Notes
macOS	14.0+ (Sonoma)	Target platform
Xcode	15.0+	Includes Swift 5.9

Optional but recommended:

Tool	Install	Purpose
SwiftLint	`brew install swiftlint`	Linting
SwiftFormat	`brew install swiftformat`	Code formatting
GitHub CLI	`brew install gh`	Used by `download-libs.sh`

Quick Start

Clone the repository

git clone https://github.com/TableProApp/TablePro.git && cd TablePro

Download native libraries

scripts/download-libs.sh

This pulls pre-built .a files (libmariadb, libpq, etc.) from GitHub Releases into Libs/. Takes a few seconds.

Skipping this step causes linker errors. The static libraries are not checked into git.

Create build config

touch Secrets.xcconfig

Empty file is fine for development. Production builds use this for API keys.

Install tools

brew install swiftlint swiftformat

Open in Xcode

open TablePro.xcodeproj

Configure signing

Select the TablePro target
Go to Signing & Capabilities
Change Team to your Apple Developer account (free account works)

Build and run

Select the TablePro scheme, set destination to My Mac, press Cmd+R.Or from the command line:

xcodebuild -project TablePro.xcodeproj -scheme TablePro -configuration Debug build -skipPackagePluginValidation

Project Structure

TablePro

Core

Views

Models

ViewModels

Extensions

Theme

Resources

Plugins

Libs

TableProTests

docs

scripts

Running Tests

# All tests
xcodebuild -project TablePro.xcodeproj -scheme TablePro test -skipPackagePluginValidation

# Specific test class
xcodebuild -project TablePro.xcodeproj -scheme TablePro test -skipPackagePluginValidation \
    -only-testing:TableProTests/TestClassName

# Specific test method
xcodebuild -project TablePro.xcodeproj -scheme TablePro test -skipPackagePluginValidation \
    -only-testing:TableProTests/TestClassName/testMethodName

Or in Xcode: Cmd+U.

Linting and Formatting

# Check for issues
swiftlint lint

# Auto-fix
swiftlint --fix

# Format all code
swiftformat .

Run swiftlint --fix && swiftformat . before committing.

Troubleshooting

Problem	Fix
Linker errors about missing symbols	Run `scripts/download-libs.sh`
SPM resolution fails	Clean build folder (`Cmd+Shift+K`), reopen Xcode
Build fails after pulling	Delete derived data: `rm -rf ~/Library/Developer/Xcode/DerivedData`
Missing `Secrets.xcconfig` error	Run `touch Secrets.xcconfig` in project root
Code signing errors	Change Team in Signing & Capabilities

The -skipPackagePluginValidation flag is required because CodeEditSourceEditor (an SPM dependency) bundles a SwiftLint plugin. Without this flag, CLI builds fail with a validation error.

​Development Setup

​Prerequisites

​Quick Start

​Project Structure

​Running Tests

​Linting and Formatting

​Troubleshooting

Development Setup

Prerequisites

Quick Start

Project Structure

Running Tests

Linting and Formatting

Troubleshooting