Skip to content

Mobile v3 docs: simplify NATIVEPHP_APP_VERSION guidance#378

Merged
simonhamp merged 1 commit into
mainfrom
noble-lynx
May 12, 2026
Merged

Mobile v3 docs: simplify NATIVEPHP_APP_VERSION guidance#378
simonhamp merged 1 commit into
mainfrom
noble-lynx

Conversation

@simonhamp
Copy link
Copy Markdown
Member

@simonhamp simonhamp commented May 12, 2026

Summary

Reworks the mobile v3 docs to better explain NATIVEPHP_APP_VERSION / NATIVEPHP_APP_VERSION_CODE and to lean on the native:release command rather than hand-editing .env.

  • installation.md — drop NATIVEPHP_APP_VERSION / _CODE from the pre-install .env block. They default to DEBUG and won't be required in the next release.
  • configuration.md — reframe the NATIVEPHP_APP_VERSION section to lead with what the vars actually are: public version string (CFBundleShortVersionString / versionName) vs. internal build number (CFBundleVersion / versionCode). Highlight DEBUG as the default and point at native:release for release builds. The "how NativePHP unpacks the bundled Laravel app on boot" mechanics move into an aside.
  • deployment.md — replace the manual .env snippet under Releasing with the native:release command, recommend semver for version numbers, and clarify that the build number is auto-incremented and persisted back to .env by the command.

Test plan

  • Render the three pages in the docs site and confirm the new copy reads well.
  • Verify the #nativerelease anchor on /docs/mobile/3/getting-started/commands resolves (slug for ### native:release).
  • Spot-check links: commands#nativerelease from configuration.md and deployment.md.

…SION

- Remove NATIVEPHP_APP_VERSION/_CODE from the pre-install .env block; they default to DEBUG and aren't required up front.
- Reframe the configuration page section: lead with what these vars actually are (public version string vs. internal build number, with iOS/Android mappings), note DEBUG is the default, and point at `native:release`. Move the bundled-Laravel extraction mechanics into an aside.
- Update the deployment Releasing section to drive readers to `native:release` instead of editing .env by hand, recommend semver for version numbers, and clarify that the build number is auto-incremented and persisted by the command.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@simonhamp simonhamp marked this pull request as ready for review May 12, 2026 17:28
@simonhamp simonhamp merged commit 0d653c9 into main May 12, 2026
2 checks passed
@simonhamp simonhamp deleted the noble-lynx branch May 12, 2026 17:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant