Skip to content

Commit

Permalink
chore(repo): update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
vsavkin committed Jan 18, 2022
1 parent 31bb2f3 commit 7b9294a
Show file tree
Hide file tree
Showing 4 changed files with 30 additions and 146 deletions.
68 changes: 10 additions & 58 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,73 +15,25 @@ width="100%" alt="Nx - Smart, Fast and Extensible Build System"></p>

<hr>

# What is Nx?
# Smart, Fast and Extensible Build System

🔎 **Smart, Fast and Extensible Build System**
Nx is a next generation build system with first class monorepo support and powerful integrations.

Nx is a smart, fast and extensible build system. It comes with first class monorepo support and powerful integrations.
A few links to help you get started:

### Best-in-Class Support for Monorepos

<strong>Nx</strong> provides distributed graph-based task execution and computation caching.

<strong>Nx</strong> is smart. It analyzes your workspace and figures out what can be affected by every code change.
That's why Nx doesn't rebuild and retest everything on every commit--<strong>it only rebuilds what is necessary</strong>
.

<strong>Nx</strong> partitions commands into a graph of smaller tasks. Nx then runs those tasks in parallel,
and <strong>it can even distribute them across multiple machines without any configuration</strong>.

<strong>Nx also uses a distributed computation cache.</strong> If someone has already built or tested similar code, Nx
will use their results to speed up the command for everyone else.

### Holistic Dev Experience Powered by an Advanced CLI and Editor Plugins

<strong>Nx</strong> helps scale your development from one team building one application to many teams building multiple
frontend and backend applications all in the same workspace. <strong >When using Nx, developers have a holistic dev
experience powered by an advanced CLI</strong > (with editor plugins), capabilities for controlled code sharing and
consistent code generation.

### Rich Plugin Ecosystem

<strong>Nx</strong> is an open platform with plugins for many modern tools and frameworks. It has support for
TypeScript, React, Angular, Cypress, Jest, Prettier, Nest.js, Next.js, Storybook, Ionic among others. With Nx, you get a
consistent dev experience regardless of the tools used.

# Documentation & Resources

Even though Nx isn't technology specific, we provide 3 separate flavours of the documentation site to it make it easier
for you to get up and running. For every link below, you will be able to select whether you want your examples to be
written in React, Node or Angular.

- [Nx Documentation and Guides](https://nx.dev)
- [Intro into Nx](https://nx.dev/getting-started/intro)
- [Interactive Tutorial with Videos](https://nx.dev/tutorial/01-create-application)

### Quick Start Videos

- [Scale Your React Development with Nx](https://www.youtube.com/watch?v=sNz-4PUM0k8)
- [Scale your Node Development with Nx](https://www.youtube.com/watch?v=iIh5h_G52kI)
- [Modern Angular with Nx Dev Tools](https://www.youtube.com/watch?v=cXOkmOy-8dk)

### Videos, Blogs, Books, Examples
- [Nx.Dev: Documentation, Guides, Interactive Tutorials](https://nx.dev)
- [Tutorial: Adding Nx to an Existing Monorepo](https://nx.dev/migration/adding-to-monorepo)
- [Official Nx YouTube Channel](https://www.youtube.com/c/Nrwl_io)
- [Blog Posts About Nx](https://blog.nrwl.io/nx/home)

<p style="text-align: center;"><a href="https://nx.dev/#learning-materials" target="_blank"><img src="./images/nx-courses-and-videos.svg"
width="100%" alt="Nx - Smart, Fast and Extensible Build System"></a></p>

- [Official Nx YouTube Channel](https://www.youtube.com/c/Nrwl_io)
- [Scale React Development with Nx (Free Egghead course)](https://egghead.io/playlists/scale-react-development-with-nx-4038)
- [Official NxPlaybook video courses](https://nxplaybook.com)
- [Nx Dev Tools for Monorepos, In-Depth Explainer (React)](https://www.youtube.com/watch?v=jCf92IyR-GE)
- [Nx Dev Tools for Monorepos, In-Depth Explainer (Angular)](https://youtu.be/h5FIGDn5YM0)
- [Blog Posts About Nx](https://blog.nrwl.io/nx/home)
- [Angular Enterprise Monorepo Patterns Book (free)](https://go.nrwl.io/angular-enterprise-monorepo-patterns-new-book?utm_campaign=Book%3A%20Monorepo%20Patterns%2C%20Jan%202019&utm_source=Github&utm_medium=Banner%20Ad)
- [Nx Examples Repo](https://github.com/nrwl/nx-examples)

# Engage with the Core Team and the Community

- [The Nx Show Playlist on YouTube](https://www.youtube.com/playlist?list=PLakNactNC1dE8KLQ5zd3fQwu_yQHjTmR5). It's
a regular YouTube stream where we talk all things Nx. Join the stream, ask questions, etc.
- [Nx.Dev Community Page: Community Slack Channel, Newsletter, etc.](https://nx.dev/community)
- [The Nx Show Playlist on YouTube](https://www.youtube.com/playlist?list=PLakNactNC1dE8KLQ5zd3fQwu_yQHjTmR5). It's a
regular YouTube stream where we talk all things Nx. Join the stream, ask questions, etc.
- [Follow Nx on Twitter](https://twitter.com/NxDevTools)

## Want to help?
Expand Down
15 changes: 12 additions & 3 deletions scripts/readme-fragments/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,17 +24,26 @@ The `create-nx-workspace` command will ask you to select a preset, which will co

```
? What to create in the new workspace (Use arrow keys)
❯ empty [an empty workspace with a layout that works best for building apps]
npm [an empty workspace set up to publish npm packages (similar to and compatible with yarn workspaces)]
❯ apps [an empty workspace with no plugins with a layout that works best for building apps]
core [an empty workspace with no plugins set up to publish npm packages (similar to yarn workspaces)]
ts [an empty workspace with the JS/TS plugin preinstalled]
react [a workspace with a single React application]
angular [a workspace with a single Angular application]
next.js [a workspace with a single Next.js application]
gatsby [a workspace with a single Gatsby application]
nest [a workspace with a single Nest application]
express [a workspace with a single Express application]
web components [a workspace with a single app built using web components]
react-native [a workspace with a single React Native application]
react-express [a workspace with a full stack application (React + Express)]
angular-nest [a workspace with a full stack application (Angular + Nest)]
```

Select the preset that works best for you.

### Adding Nx to an Existing Monorepo

Run:

```bash
npx add-nx-to-monorepo@latest
```
60 changes: 6 additions & 54 deletions scripts/readme-fragments/resources.md
Original file line number Diff line number Diff line change
@@ -1,59 +1,11 @@
## Documentation & Resources

Even though Nx isn't technology specific, we provide 3 separate flavours of the documentation site to it make it easier for you to get up and running. For every link below, you will be able to select whether you want your examples to be written in React, Node or Angular.

- [Nx Documentation and Guides](https://nx.dev)
- [Intro into Nx](https://nx.dev/getting-started/intro)
- [Interactive Tutorial with Videos](https://nx.dev/tutorial/01-create-application)

### Quick Start Videos

- [Scale Your React Development with Nx](https://www.youtube.com/watch?v=sNz-4PUM0k8)
- [Scale your Node Development with Nx](https://www.youtube.com/watch?v=iIh5h_G52kI)
- [Modern Angular with Nx Dev Tools](https://www.youtube.com/watch?v=cXOkmOy-8dk)

### Courses

<table>
<tr>
<td><strong>Scale React Development with Nx</strong></td>
<td><strong>Nx Workspaces</strong></td>
<td><strong>Advanced Nx Workspaces</strong></td>
</tr>
<tr>
<td>
<a href="https://egghead.io/playlists/scale-react-development-with-nx-4038" target="_blank">
<p style="text-align: center;"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/EGH_ScalingReactNx.png" height="150px" alt="Nx - Scale React Development with Nx video course"></p>
</a>
</td>
<td>
<a href="https://www.youtube.com/watch?v=2mYLe9Kp9VM&list=PLakNactNC1dH38AfqmwabvOszDmKriGco" target="_blank">
<p style="text-align: center;"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-workspace-course.png" width="350" alt="Nx Workspaces video course"></p>
</a>
</td>
<td>
<a href="https://nxplaybook.com/p/advanced-nx-workspaces" target="_blank">
<p style="text-align: center;"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/advanced-nx-workspace-course.png" width="350" alt="Nx Advanced Workspaces video course"></p>
</a>
</td>
</tr>
</table>

### Videos, Blogs, Books, Examples

- [Nx Dev Tools for Monorepos, In-Depth Explainer (React)](https://www.youtube.com/watch?v=jCf92IyR-GE)

- [Nx Dev Tools for Monorepos, In-Depth Explainer (Angular)](https://youtu.be/h5FIGDn5YM0)

- [Youtube Channel with Nx-Related Videos](https://www.youtube.com/playlist?list=PLakNactNC1dHHWx4JIORwfnEajRv6FG5m)
A few links to help you get started:

- [Nx.Dev: Documentation, Guides, Interactive Tutorials](https://nx.dev)
- [Tutorial: Adding Nx to an Existing Monorepo](https://nx.dev/migration/adding-to-monorepo)
- [Official Nx YouTube Channel](https://www.youtube.com/c/Nrwl_io)
- [Blog Posts About Nx](https://blog.nrwl.io/nx/home)

- [Angular Enterprise Monorepo Patterns Book (free)](https://go.nrwl.io/angular-enterprise-monorepo-patterns-new-book?utm_campaign=Book%3A%20Monorepo%20Patterns%2C%20Jan%202019&utm_source=Github&utm_medium=Banner%20Ad)

- [Nx Examples Repo](https://github.com/nrwl/nx-examples)

# Engage with the Core Team and the Community

- [The Nx Show Playlist on YouTube](https://www.youtube.com/playlist?list=PLakNactNC1dE8KLQ5zd3fQwu_yQHjTmR5). It's a regular YouTube stream where we talk all things Nx. Join the stream, ask questions, etc.
- [Follow Nx on Twitter](https://twitter.com/NxDevTools)
<p style="text-align: center;"><a href="https://nx.dev/#learning-materials" target="_blank"><img src="./images/nx-courses-and-videos.svg"
width="100%" alt="Nx - Smart, Fast and Extensible Build System"></a></p>
33 changes: 2 additions & 31 deletions scripts/readme-fragments/what-is-nx.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,3 @@
## What is Nx?
# Smart, Fast and Extensible Build System

🔎 **Smart, Fast and Extensible Build System**

Nx is a smart, fast and extensible build system. It comes with first class monorepo support and powerful integrations.

### Best-in-Class Support for Monorepos

<strong>Nx</strong> provides distributed graph-based task execution and computation caching.

<strong>Nx</strong> is smart. It analyzes your workspace and figures out what can be affected by every code change.
That's why Nx doesn't rebuild and retest everything on every commit--<strong>it only rebuilds what is necessary</strong>
.

<strong>Nx</strong> partitions commands into a graph of smaller tasks. Nx then runs those tasks in parallel,
and <strong>it can even distribute them across multiple machines without any configuration</strong>.

<strong>Nx also uses a distributed computation cache.</strong> If someone has already built or tested similar code, Nx
will use their results to speed up the command for everyone else.

### Holistic Dev Experience Powered by an Advanced CLI and Editor Plugins

<strong>Nx</strong> helps scale your development from one team building one application to many teams building multiple
frontend and backend applications all in the same workspace. <strong >When using Nx, developers have a holistic dev
experience powered by an advanced CLI</strong > (with editor plugins), capabilities for controlled code sharing and
consistent code generation.

### Rich Plugin Ecosystem

<strong>Nx</strong> is an open platform with plugins for many modern tools and frameworks. It has support for
TypeScript, React, Angular, Cypress, Jest, Prettier, Nest.js, Next.js, Storybook, Ionic among others. With Nx, you get a
consistent dev experience regardless of the tools used.
Nx is a next generation build system with first class monorepo support and powerful integrations.

0 comments on commit 7b9294a

Please sign in to comment.