Add xcconfig templates and ConfigKey protocol

[ssestak]

Summary

Adds xcconfig-based configuration management to the SwiftUI App template with per-environment config files (Debug, Beta, Release, Local) and a new ConfigKey protocol in FuturedHelpers for type-safe Info.plist value retrieval with automatic Base64 decoding.

Changes

• ConfigKey protocol with default implementation that reads from Bundle.main Info.plist and auto-decodes Base64 values
• ConfigKeyError with descriptive error messages guiding developers to check xcconfig/Info.plist wiring
• Debug config includes Local.xcconfig via #include? for git-ignored local secrets
• Beta and Release configs are empty by design — values injected via CI
• TemplateInfo.plist updated to wire all xcconfig files into the Xcode project template under a Configuration group

Diagram

View diagram

flowchart TD
    subgraph xcconfig["xcconfig files"]
        Local["Local.xcconfig\n(git-ignored secrets)"]
        Debug["Debug.xcconfig\n(dev settings)"]
        Beta["Beta.xcconfig\n(CI injected)"]
        Release["Release.xcconfig\n(CI injected)"]
    end

    Local -->|"#include?"| Debug
    Debug --> Build["Build Settings"]
    Beta --> Build
    Release --> Build
    Build --> Plist["Info.plist\n$(KEY_NAME)"]
    Plist --> ConfigKey["ConfigKey protocol\n(auto Base64 decode)"]
    ConfigKey --> App["App code\ntry AppConfigKey.apiKey.value"]

Loading

Notes

• Local.xcconfig should be added to .gitignore in consumer projects to keep secrets out of version control