Skip to content

Conversation

@grabbou
Copy link
Contributor

@grabbou grabbou commented Oct 1, 2025

Revised and restructure the documentation with proper and clearer messaging, direct follow-up to previous PR by @thymikee, opening here to see it live and for visibility.

Updates wording around "enterprise" because it's too vague and doesn't convey the actual problems we solve. I'd like this messaging to emphasize Rock's strengths, where it shines and where it doesn't (hence mentioning Expo and @cpojer's template for new projects).

Supersedes #590. Needs new tagline, but this one we can work with later (CC: @thymikee)
Add anti-pitch/tradefoffs

@changeset-bot
Copy link

changeset-bot bot commented Oct 1, 2025

🦋 Changeset detected

Latest commit: b090693

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages
Name Type
rock Patch
rock-docs Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
Copy link

vercel bot commented Oct 1, 2025

@grabbou is attempting to deploy a commit to the Callstack Team on Vercel.

A member of the Team first needs to authorize it.

@vercel
Copy link

vercel bot commented Oct 1, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Preview Comments Updated (UTC)
rock Ignored Ignored Preview Oct 2, 2025 11:26am

Copy link
Contributor

@thymikee thymikee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, thanks!

@grabbou grabbou changed the title feat: update website/docs for Rock feat: update website, docs and readme Oct 2, 2025
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR is being reviewed by Cursor Bugbot

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

@thymikee thymikee merged commit 810cafa into callstackincubator:main Oct 2, 2025
6 checks passed
</a>
<p align="center">
🪨 Rock is a cross-platform React Native app development and build toolchain built for modularity, build reuse, and incremental adoption. It integrates seamlessly with your existing infrastructure, giving you complete control without vendor lock-in.
🪨 Rock is a modular toolkit for teams building React Native apps. It helps improve build times and developer experience while fitting into your existing workflows and infrastructure.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is a really nice description!


To migrate an existing project, open a terminal in your project root and run:
> [!TIP]
> For **new projects**, we recommend starting with [Expo](https://expo.dev) for the best developer experience and similar remote caching capabilities. Rock is designed for teams who have outgrown the Community CLI.
Copy link

@brentvatne brentvatne Oct 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

one interesting thing to clarify here, perhaps not here but somewhere, can you use rock in expo projects? when would you do that and what would the benefits be? any tradeoffs?

- **Existing React Native teams using Community CLI** who want to improve build times and developer experience while fitting into your existing workflows and infrastructure.
- **iOS/Android native teams** planning to incorporate React Native without disrupting existing workflows: Rock Brownfield lets you add your whole React Native app like any other dependency.

:::info New to React Native and building app from scratch?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe around here is where you could explain whether rock works in expo projects or not

@brentvatne
Copy link

excellent improvements! this greatly improves the clarity of the docs, well done

---

## React Native at scale is challenging
## Key Features
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section reads a lot better. It's very clear what Rock does in practice.

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.

4 participants