Skip to content

[iOS][swiftpm] Documentation updates - #58084

Open
chrfalch wants to merge 1 commit into
spm/spm-modules-guardfrom
spm/library-author-docs
Open

[iOS][swiftpm] Documentation updates#58084
chrfalch wants to merge 1 commit into
spm/spm-modules-guardfrom
spm/library-author-docs

Conversation

@chrfalch

@chrfalch chrfalch commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator

Summary:

There were some missing explanation regarding naming of SwiftPM modules which led to some issues for library authors, and based on changes in the functionality the docs also needed a few minor updates to support these changes (we're still in preview, so changes are expected).

This was seen in the PR here powersync-ja/powersync-js#1076.

This PR updates the docs.

Changelog:

[IOS] [FIXED] - Updated SwiftPM documentation

Test Plan:

✅ Verify that the docs are aligned with the implementation

The derivation rule, the `spm.name` override and the names React Native
reserves were only discoverable from the autolinker's source or from the error a
collision produces. Write them down where a library author looks: the scoped
package case that surprises people (`@scope/react-native` derives `ReactNative`,
and gets its scope back as `ScopeReactNative`), the two reasons to set
`spm.name` and its charset, the reserved names in one table, what happens when
two libraries derive the same name — who moves, who stays, and when the build
fails anyway — and the npm `files` requirement that makes the override reach
consumers at all.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Aug 24, 2026
@github-actions

Copy link
Copy Markdown

Caution

Invalid Base Branch

The base branch for this PR is spm/spm-modules-guard, which is not main or a -stable branch.
Are you sure you want to target this branch?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. p: Expo Partner: Expo Partner

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant