docs: add changes over obytes starter page by devs-rootstrap · Pull Request #160 · rootstrap/react-native-template

devs-rootstrap · 2026-10-28T01:23:57Z

Jira board reference:

Add changes introduced by Rootstrap section at docs

What does this do?

Adds a new documentation page, Changes over Obytes Starter (docs/src/content/docs/changes-over-obytes.md), with a concrete list of what we changed or added on top of the Obytes starter, grouped by area:

Project setup and CLI
Authentication and networking
Environments, EAS and CI
Code quality and tooling
Coding assistants
Keeping the template and your projects up to date

Every bullet names the specific change and links to the merged pull request that introduced it. The page is registered in the Starlight sidebar right after "Overview" (with the new badge) and linked from the documentation list in README.md.

Why did you do this?

There was no quick way for someone evaluating the template to tell how it differs from the Obytes starter; the information only lived in individual pull request descriptions. A client asked exactly this question, so the differences are now documented in one place that we can keep up to date as the template evolves.

Who/what does this impact?

Documentation only. No application code, workflows or configuration are affected. Anyone comparing this template with the upstream starter, and the team when onboarding new projects or answering client questions.

Layer 2: Risk Classification

Author applies a risk label when opening the PR. When in doubt, escalate.

Label	When to use
`risk:low`	Config, copy, minor UI tweaks. Low blast radius.
`risk:medium`	Feature work, refactors touching multiple files.
`risk:high`	Auth, payments, migrations, security-sensitive code.

Setup

Create risk:low, risk:medium, risk:high labels in the repo
Add risk criteria to contributing guide or PR template
Add reminder in PR template to apply the label before requesting review
Define who can override/escalate (suggested: tech lead)

How did you test this?

Documentation-only change; verified by building the docs site locally and checking the generated page (sidebar entry, internal links and all pull request links present).

Notes:

Assumptions

Only changes that can be verified in this repository (code, workflows, merged pull requests) are listed. Features that also exist upstream (for example the Sentry recipe or the stale workflow) are intentionally left out.
The CLI rename is attributed to the first pull request that introduced it (chore(cli): rename CLI to create-rootstrap-rn-app #17), even though a second pull request with the same title (chore(cli): rename CLI to create-rootstrap-rn-app #20) was merged a few days later.

Verification

pnpm lint, pnpm type-check, pnpm lint:translations, pnpm test: passing (28 suites, 139 tests).
Docs build (cd docs && pnpm build): the new page is generated correctly (dist/changes-over-obytes/index.html), but the full build still stops on a pre-existing issue unrelated to this change: getting-started/rules-and-conventions.mdx embeds .eslintrc.js, which no longer exists since the ESLint migration (Feat/prettier to antfu #147). A few other embeds point to files that were moved or removed (src/components/card.tsx, src/api/posts/*, src/components/login-form.test.tsx). The deploy-docs workflow has been failing for the same reason since v1.8.0. Worth a follow-up.
cd docs && pnpm install --frozen-lockfile fails with ERR_PNPM_BROKEN_LOCKFILE (duplicate key hast-util-from-html@2.0.3) on the committed lockfile; the lockfile was left untouched in this PR.

Preview locally

cd docs && pnpm install && pnpm dev

Then open /react-native-template/changes-over-obytes/.

Screenshots / Previews

Not applicable (documentation only).

github-actions · 2026-10-28T01:24:56Z

💯 Test Coverage

Lines	Statements	Branches	Functions
	56.23% (347/617)	59.18% (174/294)	48.76% (118/242)

😎 Tests Results

Tests	Skipped	Failures	Errors	Time
139	0 💤	0 ❌	0 🔥	31.048s ⏱️

👀 Tests Details • (56%)

File	% Stmts	% Branch	% Funcs	% Lines	Uncovered Line #s
All files	56.23	59.18	48.76	56.9

report-only-changed-files is enabled. No files were changed in this commit :)

Copilot

🟡 Changes recommended

The documentation contains broken published-site links and inaccurate claims about default-branch build compatibility and 401 response handling.

3 open issues

What changed in this PR

Overall Review: ai:minor

This documentation-only PR gives developers a central reference for Rootstrap’s changes to the Obytes starter, making template evaluation and project onboarding easier.

Changes:

Adds a categorized comparison page covering setup, authentication, CI, tooling, coding assistants, and updates.
Adds navigation links in the documentation sidebar and README.

File	Description
`README.md`	Links to the new comparison page.
`docs/src/content/docs/changes-over-obytes.md`	Documents Rootstrap-specific changes with supporting PR references.
`docs/astro.config.mjs`	Registers the page after Overview with a `new` badge.

_{Review effort: Balanced}

+This template is a fork of the [Obytes starter](https://github.com/obytes/react-native-template-obytes). We keep everything that makes the original great and periodically merge its new releases, but we also adjust it to the way we build apps at Rootstrap. This page lists those adjustments so you can quickly tell what is different without digging through the pull request history.
+
+:::note
+The list below only covers changes we made on top of the upstream starter. For the features that come from Obytes, check the [Overview](/overview) page and the [upstream changelog](https://github.com/obytes/react-native-template-obytes/releases). Every item links to the pull request that introduced it in the [template repository](https://github.com/rootstrap/react-native-template).


+
+- **`create-rootstrap-rn-app` CLI.** The CLI was renamed and republished under our own npm package, and it clones the latest release of this repository instead of the upstream one ([#17](https://github.com/rootstrap/react-native-template/pull/17), [#18](https://github.com/rootstrap/react-native-template/pull/18)). A manual GitHub Action publishes new CLI versions to npm ([#23](https://github.com/rootstrap/react-native-template/pull/23)).
+- **Project clean-up on creation.** The CLI removes template-only files (docs site, CLI, docs and CLI deploy workflows, license), renames `README-project.md` to `README.md`, sets the project name in `env.js`, the Expo config slug and the README, and strips the template warning from the pull request template ([#62](https://github.com/rootstrap/react-native-template/pull/62), [#64](https://github.com/rootstrap/react-native-template/pull/64), [#65](https://github.com/rootstrap/react-native-template/pull/65), [#66](https://github.com/rootstrap/react-native-template/pull/66)).
+- **Git branches out of the box.** New projects are initialized with an initial commit on `develop` plus `qa` and `main` branches, matching the branch-to-environment mapping used by the build workflow ([#158](https://github.com/rootstrap/react-native-template/pull/158)).


+
+- **Axios interceptors with automatic case conversion.** Request bodies are converted to `snake_case` and responses to `camelCase`, including nested objects, so the TypeScript code always uses `camelCase` ([#6](https://github.com/rootstrap/react-native-template/pull/6), [#28](https://github.com/rootstrap/react-native-template/pull/28), [#119](https://github.com/rootstrap/react-native-template/pull/119)).
+- **Devise Token Auth support.** The interceptors inject the `access-token`, `client`, `uid`, `expiry` and `Authorization` headers on every request and capture them from responses, so the template works out of the box with a Rails API using Devise Token Auth ([#85](https://github.com/rootstrap/react-native-template/pull/85), [#116](https://github.com/rootstrap/react-native-template/pull/116)).
+- **`AuthProvider` context.** A React context keeps tokens in a dedicated MMKV instance, exposes `isAuthenticated` / `ready` / `logout` to the UI and handles `401` responses, complementing the Zustand store inherited from upstream ([#116](https://github.com/rootstrap/react-native-template/pull/116)).


asdolo · 2026-10-28T02:03:34Z

@@ -0,0 +1,72 @@
+---
+title: Changes over Obytes Starter
+description: A concrete list of what Rootstrap changed or added on top of the Obytes React Native / Expo starter.


I think this is a bit explicit. Make it sound more natural.

@asdolo Reworded the description in d9dc89c. It now reads: "What Rootstrap changed and added on top of the Obytes React Native / Expo starter." The intro paragraph was left as is since it already reads naturally.

Like it better but what about using like a team player tone? "What our talented team of engineers at Rootstrap have added so far on top of the Obytes starter?"

@fernandatoledo Good call, updated in 6baeb6a. The description now reads: "What our talented team of engineers at Rootstrap has added so far on top of the Obytes starter." I kept it as a statement rather than a question since it shows up as the page summary/meta description.

asdolo · 2026-10-28T02:06:35Z

Keep the user-facing changes first, as that's what people would like to read first. Leave the infra/misc/chore changes in the end of the list. I think titles are good as they are now.

@asdolo Reordered in d9dc89c, titles untouched. "Authentication and networking" now opens the page (screens and routes listed before the interceptors and query key factory), followed by "Project setup and CLI", "Environments, EAS and CI", "Code quality and tooling", "Coding assistants" and "Keeping the template and your projects up to date". Within sections, workflow/repo-chore items were kept at the end; no items were added or removed.

devs-rootstrap added the risk:low Config, copy, minor UI tweaks. Low blast radius. label Oct 28, 2026

asdolo marked this pull request as ready for review October 28, 2026 01:53

Copilot AI balanced review requested due to automatic review settings October 28, 2026 01:53

asdolo requested a review from a team as a code owner October 28, 2026 01:53

asdolo requested review from amaury901130, asdolo and fernandatoledo October 28, 2026 01:53

Copilot started reviewing on behalf of asdolo October 28, 2026 01:53

View session

Copilot AI reviewed Oct 28, 2026

View reviewed changes

docs: add changes over obytes starter page

ebe8089

devs-rootstrap force-pushed the docs/rootstrap-changes-over-obytes branch from 5f7e673 to ebe8089 Compare October 28, 2026 01:56

asdolo requested changes Oct 28, 2026

View reviewed changes

devs-rootstrap added 2 commits October 27, 2026 23:20

docs: reorder changes page and soften description

d9dc89c

docs: use a team tone in changes over obytes description

6baeb6a

fernandatoledo approved these changes Oct 28, 2026

View reviewed changes

Navigation Menu

Repository navigation

docs: add changes over obytes starter page - #160

docs: add changes over obytes starter page#160
devs-rootstrap wants to merge 3 commits into
masterfrom
docs/rootstrap-changes-over-obytes

devs-rootstrap commented Oct 28, 2026

Uh oh!

github-actions Bot commented Oct 28, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

asdolo Oct 28, 2026

Uh oh!

devs-rootstrap Oct 28, 2026

Uh oh!

fernandatoledo Oct 28, 2026

Uh oh!

devs-rootstrap Oct 28, 2026

Uh oh!

asdolo Oct 28, 2026

Uh oh!

devs-rootstrap Oct 28, 2026

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

devs-rootstrap commented Oct 28, 2026

Jira board reference:

What does this do?

Why did you do this?

Who/what does this impact?

Layer 2: Risk Classification

How did you test this?

Notes:

Screenshots / Previews

Uh oh!

github-actions Bot commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

💯 Test Coverage

😎 Tests Results

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

asdolo Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

devs-rootstrap Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

fernandatoledo Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

devs-rootstrap Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

asdolo Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

devs-rootstrap Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions Bot commented Oct 28, 2026 •

edited

Loading