docs: add new command reference (#651)

Author: renancaraujo

README.md

@@ -66,6 +66,18 @@ Create a production build which includes a `DockerFile` so that you can deploy a
 dart_frog build
 ```
 
+### Create New Routes and Middleware 🛣️
+
+To add new routes and middleware to your project, use the `dart_frog new` command.
+
+```sh
+# 🛣️ Create a new route "/hello/world"
+dart_frog new route "/hello/world"
+
+# 🛣️ Create a new middleware for the route "/hello/world"
+dart_frog new middleware "/hello/world"
+```
+
 ## Goals 🎯
 
 Dart Frog is built on top of [shelf](https://pub.dev/packages/shelf) and [mason](https://pub.dev/packages/mason) and is inspired by many tools including [remix.run](https://remix.run), [next.js](https://nextjs.org), and [express.js](https://expressjs.com).

docs/docs/basics/middleware.md

@@ -36,3 +36,12 @@ Handler middleware(Handler handler) {
   return handler.use(requestLogger());
 }
 ```
+
+## Creating Middleware
+
+To create new middleware on a Dart Frog project, run the following command:
+
+```bash
+# Creates routes/hello/_middleware.dart
+dart_frog new middleware "/hello"
+```

docs/docs/basics/routes.md

@@ -19,6 +19,15 @@ Response onRequest(RequestContext context) {
 }
 ```
 
+## Creating Routes
+
+Managing routes in Dart Frog is essentially as simple as managing the file structure under `/routes`. To help on the creation of routes, Dart Frog provides a CLI command to generate a new route.
+
+```shell
+# will create routes/hello.dart
+dart_frog new route "/hello"
+```
+
 ## Requests 📥
 
 All route handlers have access to information regarding the inbound request. In this section, we'll take a look at various ways in which we can interact with the inbound request.

docs/docs/roadmap.md

@@ -42,7 +42,7 @@ In the interest of transparency, we want to share high-level details of our road
 - [ ] Dart API Client Generation
 - [ ] Open API Documentation Generation
 - [ ] DartFrog Testing Library (utilities for unit and e2e testing)
-- [ ] CLI `new` command to generate new `routes` and `middleware`
+- [x] CLI `new` command to generate new `routes` and `middleware`
 - [ ] Health Check endpoint for monitoring
 - [ ] Logger which can be configured to adhere to standard log formats (https://cloud.google.com/run/docs/logging)
 - [x] WebSocket support