diff --git a/README.md b/README.md index f3d7e6516..3db01fa0e 100644 --- a/README.md +++ b/README.md @@ -1,37 +1,52 @@ -# React Native Developer Tools +# `rnx-kit` - React Native tooling by and for developers [![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&color=007acc&labelColor=444444&logoColor=007acc)](https://vscode.dev/github/microsoft/rnx-kit) [![Build](https://github.com/microsoft/rnx-kit/actions/workflows/build.yml/badge.svg)](https://github.com/microsoft/rnx-kit/actions/workflows/build.yml) -### Modern, scalable tools. Exceptional developer experience. +`rnx-kit` is a collection of battle-tested tools created by Microsoft engineers +to optimize the React Native developer experience. It helps filling gaps in the +React Native ecosystem and streamlines the developer workflow. -You can find guides, documentation, resources, and our blog on the -[project website](https://microsoft.github.io/rnx-kit). +These tools are actively used every day to ship React Native apps at scale +across Microsoft; now they're open source and available for any React Native +project. -### Made by Developers, for Developers. +## What's included -_Purpose-built for React Native engineers. Focused on developer experience. -Designed to fit into any project, no matter how large or complex._ +`rnx-kit` includes tools for: -_Great tools make all the difference._ +- Dependency management - Ensure consistent dependency versions across large + projects with `align-deps`. +- Native builds (experimental) - Build Android and iOS apps in the cloud with + `build`. Avoid installing heavy native toolchains. +- Better bundling - `metro-serializer` allows the enhancement of Metro to add + features such as TypeScript validation with Metro, tree shaking, duplicate and + cyclic dependencies detection. +- Microsoft-tailored defaults - you can find Babel preset for Metro opinionated + for Microsoft usage. -### Community First +And many more! -_Created as a GitHub-first repository for the React Native community. Integrated -with tools you already use: Metro, TypeScript, Jest, and more._ +## Get started -_Join in! Your contributions are always welcome._ +Please follow +[Introduction guide](https://microsoft.github.io/rnx-kit/docs/introduction) on +the documentation website to learn about how you can quickly add the "all in +one" CLI to your project and get most of the tools set out of the box. -### Tested at scale. Supported by Microsoft. +Or follow the +[Getting started guide](https://microsoft.github.io/rnx-kit/docs/guides/getting-started) +for an easy introduction to our dependency management tool. -_From unit tests to deployments in large monorepos, each tool is thoroughly -validated. Microsoft has engineers dedicated to this project, using it to ship -React Native apps to millions of customers._ +If you want to use only a specific tool, you can refer to its `README`` for +details; they are all easily readable in the +[Tools section](https://microsoft.github.io/rnx-kit/docs/tools/overview) of the +documentation. -### Contributing +## Contributing -Thank you for your interest in this project! We welcome all contributions and -suggestions! +`rnx-kit` is built for the community, by the community - and maintained by +Microsoft engineers. Your contributions are welcome! Take a look at [CONTRIBUTING](https://github.com/microsoft/rnx-kit/tree/main/CONTRIBUTING.md) @@ -39,3 +54,16 @@ for details. If you are interested in proposing "substantial" changes, please refer to our [RFC process](https://github.com/microsoft/rnx-kit/tree/rfcs). + +## License + +[MIT License](LICENSE) + +## Code of Conduct + +This project has adopted the +[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). +For more information see the +[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or +contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any +additional questions or comments. diff --git a/docsite/docs/architecture/overview.md b/docsite/docs/architecture/overview.md index 9bde647b7..259f7d01b 100644 --- a/docsite/docs/architecture/overview.md +++ b/docsite/docs/architecture/overview.md @@ -5,7 +5,7 @@ want to understand **why**. What's going on inside of a particular tool? What decisions led to that design? Don't see the topic you're looking for? Do you have specific questions that -aren't answered here? Take a look at the [Resources](../resources) area. You'll +aren't answered here? Take a look at the [Community](../community) area. You'll find talks, podcasts, recorded streaming sessions, and other materials that may help you out. You'll also find links to the developer community where you can ask questions and get help. diff --git a/docsite/docs/resources.mdx b/docsite/docs/community.mdx similarity index 59% rename from docsite/docs/resources.mdx rename to docsite/docs/community.mdx index a22554085..24e20b75e 100644 --- a/docsite/docs/resources.mdx +++ b/docsite/docs/community.mdx @@ -1,52 +1,45 @@ import Image from "@site/src/components/Image"; -# Resources - -Need help? Have an idea or code you want to share? Looking to meet other -developers using `rnx-kit`? - -You're in the right place! +# Community The resources below are ways to reach us and the larger community. Plus, you'll find videos, talks, streaming sessions and podcasts, all about the tools in this project. -## Social +### Interact with us!

- Twitter Logo - Adam Foxman (@afoxman4) - -

- -

- Discord Logo - - Adam Foxman (afoxman#4801) - + GitHub Logo + The primary way to interact with us is via the rnx-kit{" "} + Issues + {", "} + Discussions + {", and "} + Project Board{" "} + sections.

Twitter Logo - - React Native at Microsoft (@ReactNativeMSFT) - + If you want to keep up with everything React Native at Microsoft, you can + follow our Twitter account{" "} + @ReactNativeMSFT

-## Community -

- GitHub Logo - rnx-kit Issues - {", "} - Discussions - {", and "} - Project Board + Microsoft Logo + You can also subscribe to the official{" "} + + React Native at Microsoft devblog + {" "} + to be in the loop with all the latest news.

+### Keep up with React Native +

React Native Logo React Native Community @@ -59,7 +52,29 @@ project.

-## Videos +## Talks + +### Videos + + + + -## Podcasts +### Podcasts