Contributing
We welcome contributions from everyone! Here's how to get involved.
Ways to Contribute
- Report issues — Found a bug or inconsistency? Open an issue.
- Submit proposals — Have an idea for improving the spec? See the Proposals page.
- Improve docs — Fix typos, clarify language, or add examples.
- Review PRs — Help review pull requests from other contributors.
Website Development
The documentation site for Re in Act is published at re-in-act.org.
To work on the site locally:
pnpm install
pnpm dev
Then open http://localhost:3000.
Useful scripts:
| Command | Purpose |
|---|---|
pnpm dev | Start the local development server |
pnpm build | Build the production site and OpenNext worker bundle |
pnpm check | Run a production build and TypeScript check |
pnpm lint | Run oxlint |
pnpm fmt:check | Check formatting with oxfmt |
pnpm preview | Build and preview the OpenNext output locally |
pnpm deploy | Build and deploy the OpenNext output to Cloudflare Workers |
Project structure notes:
- Content lives in
docs/**/*.mdx. - Navigation is configured in
docs/docs.json. - App routes are resolved by
src/app/[...slug]/page.tsx.
Deployment note:
- Cloudflare deploys expect the
.open-nextoutput frompnpm build. - The build flow is
next buildfollowed byopennextjs-cloudflare build --skipNextBuild, so the Next app is compiled once and the OpenNext worker bundle is produced without recursive script calls.
Join the Conversation
- GitHub — Track issues and proposals in the RIA-Spec/re-in-act repository.
- X — Follow the draft author at @yaoandyan.
- Discord — Public invite pending. Until the server link is published, use GitHub Issues for coordination.
Code of Conduct
Until a standalone code-of-conduct document is added, all contributors are expected to follow the project participation and review norms described in Governance.