SBConstants
A command-line tool that automatically generates a constants file from identifiers found in iOS/macOS storyboards.
What is SBConstants?
SBConstants is a command-line tool that generates a constants file by extracting identifiers from storyboards in iOS or macOS projects. It automates the process of creating type-safe constants for segues, storyboard names, and cell reuse identifiers, reducing the risk of typos and making code more maintainable.
iOS and macOS developers using Xcode and storyboards who want to eliminate hard-coded strings and manage identifiers programmatically.
Developers choose SBConstants because it integrates seamlessly into Xcode build phases, supports both Objective-C and Swift, and offers customizable queries and templates to fit any project's needs.
Overview
SBConstants is a Ruby gem that scans storyboard files in an Xcode project and extracts identifiers (like segue identifiers, storyboard names, and cell reuse identifiers) to generate a constants file. This eliminates the need for hard-coded strings, reducing errors and improving maintainability in iOS and macOS development.
Key Features
- Automatic Constant Generation — Parses storyboard XML files to find identifiers and creates corresponding constants in Objective-C or Swift.
- Build Script Integration — Can be added as a build phase in Xcode to regenerate constants automatically on each build.
- Customizable Queries — Supports a YAML file to define which identifiers to extract, allowing extensibility beyond the default set.
- Flexible Output Formats — Generates Objective-C
.h/.mfiles or Swift enums with the--swiftflag. - Custom Templates — Allows overriding the default code formatting with custom ERB templates for team coding conventions.
- Filtering Options — Includes flags to ignore specific files, filter by prefix, and specify source directories.
Philosophy
SBConstants believes in automating repetitive tasks to let developers focus on building features, ensuring that storyboard identifiers are consistently managed and type-safe.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
