docs(site): v1 updates (#1492)

* docs(site): v1 updates

* fix: warnings and improve docs

Author: marcossevilla

site/docs/commands/check_licenses.md

@@ -101,6 +101,31 @@ very_good packages check licenses --ignore-retrieval-failures
 # ✓ Retrieved 6 licenses from 6 packages of type: BSD-3-Clause (3), MIT (1), unknown (1) and Apache-2.0 (1).
 ```
 
+### `reporter`
+
+Lists all packages with their licenses in a specific format. This is useful for generating reports or auditing dependencies.
+
+Available formats:
+
+- `text`: Lists licenses without a specific format (e.g., `package_name - MIT`).
+- `csv`: Lists licenses in a CSV format (e.g., `package_name,MIT`).
+
+#### Example usage:
+
+```sh
+very_good packages check licenses --reporter=text
+
+# package_a - MIT
+# package_b - BSD-3-Clause
+# package_c - Apache-2.0
+
+very_good packages check licenses --reporter=csv
+
+# package_a,MIT
+# package_b,BSD-3-Clause
+# package_c,Apache-2.0
+```
+
 ## Supported licenses 💳
 
 The license detection is processed by [Dart's package analyzer](https://pub.dev/packages/pana), which reports commonly found licenses (SPDX licenses). The list of accepted licenses can be seen in the [SPDX GitHub repository](https://github.com/spdx/license-list-data/tree/main/text) or in the [SPDX License enumeration](https://github.com/VeryGoodOpenSource/very_good_cli/blob/main/lib/src/pub_license/spdx_license.gen.dart). Therefore, when specifying a license within arguments it must strictly match with the SPDX license name.

site/docs/commands/mcp.md

@@ -0,0 +1,137 @@
+---
+sidebar_position: 4
+---
+
+# MCP Server 🤖
+
+Start the MCP (Model Context Protocol) server for AI assistant integration with `very_good mcp`.
+
+:::warning
+This command relies on the [Dart MCP Server](https://docs.flutter.dev/ai/mcp-server). This is an experimental package and may change or become unstable without notice. Use it with caution at your own risk.
+:::
+
+## Usage
+
+```sh
+very_good mcp [arguments]
+-h, --help    Print this usage information.
+
+Run "very_good help" to see global options.
+```
+
+The MCP server exposes Very Good CLI functionality through the [Model Context Protocol](https://modelcontextprotocol.io/), allowing AI assistants to interact with the CLI programmatically. This enables automated project creation, testing, and package management through MCP-compatible tools.
+
+## Configuration
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<Tabs>
+  <TabItem value="claude-desktop" label="Claude Desktop" default>
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "very_good_cli": {
+      "command": "very_good",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+  </TabItem>
+  <TabItem value="claude-code" label="Claude Code">
+
+Add to `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "very_good_cli": {
+      "command": "very_good",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+  </TabItem>
+  <TabItem value="cursor" label="Cursor">
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "very_good_cli": {
+      "command": "very_good",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+  </TabItem>
+  <TabItem value="vscode" label="VS Code / GitHub Copilot">
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "very_good_cli": {
+      "command": "very_good",
+      "args": ["mcp"],
+      "type": "stdio"
+    }
+  }
+}
+```
+
+  </TabItem>
+  <TabItem value="windsurf" label="Windsurf">
+
+Add to `~/.windsurf/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "very_good_cli": {
+      "command": "very_good",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+  </TabItem>
+</Tabs>
+
+## Available Tools
+
+The MCP server exposes the following tools to AI assistants:
+
+### `create`
+
+Create new Dart or Flutter projects from any of the available [templates](/docs/category/templates).
+
+### `test`
+
+Run tests with optional coverage and optimization. Supports both `dart test` and `flutter test` via a `dart` parameter.
+
+See the [test command](/docs/commands/test) for more details.
+
+### `packages_get`
+
+Install or update Dart/Flutter package dependencies.
+
+See the [get packages command](/docs/commands/get_pkgs) for more details.
+
+### `packages_check_licenses`
+
+Check packages for license compliance.
+
+See the [check licenses command](/docs/commands/check_licenses) for more details.

site/docs/commands/test.md

@@ -30,6 +30,15 @@ very_good test [arguments]
     --force-ansi                      Whether to force ansi output. If not specified, it will maintain the default behavior based on stdout and stderr.
     --platform                        The platform to run tests on. For Flutter tests, this can be "chrome", "vm", "android", "ios", etc. For Dart tests, this can be "chrome", "vm", etc.
     --dart-define=<foo=bar>           Additional key-value pairs that will be available as constants from the String.fromEnvironment, bool.fromEnvironment, int.fromEnvironment, and double.fromEnvironment constructors. Multiple defines can be passed by repeating "--dart-define" multiple times.
+    --dart-define-from-file=<use-define-config.json|.env>
+                                      The path of a .json or .env file containing key-value pairs that will be
+                                      available as environment variables. Multiple defines can be passed by
+                                      repeating "--dart-define-from-file" multiple times. Entries from
+                                      "--dart-define" with identical keys take precedence.
+    --collect-coverage-from=<imports|all>
+                                      Whether to collect coverage from imported files only or all files.
+                                      (defaults to "imports")
+    --fail-fast                       Stop running tests after the first failure.
 
 Run "very_good help" to see global options.
 ```

site/docs/overview.md

@@ -15,7 +15,7 @@ Very Good CLI is a Command-Line Interface that enables you to generate VGV-opini
 In order to use Very Good CLI you must have [Dart][dart_sdk] and [Flutter][flutter_sdk] installed on your machine.
 
 :::info
-Very Good CLI requires Dart `">=3.1.0 <4.0.0"`
+Very Good CLI requires Dart `">=3.11.0 <4.0.0"`
 :::
 
 ## Installing
@@ -111,6 +111,9 @@ very_good packages check licenses --forbidden="unknown"
 
 # Check licenses for certain dependencies types
 very_good packages check licenses --dependency-type="direct-main,transitive"
+
+# Check and list licenses in the current directory
+very_good packages check licenses --reporter="csv"
 ```
 
 ### `very_good test`
@@ -135,6 +138,12 @@ very_good test --recursive
 
 # Run tests recursively (shorthand)
 very_good test -r
+
+# Run tests and stop after the first failure
+very_good test --fail-fast
+
+# Run tests and collect coverage from all files
+very_good test --coverage --collect-coverage-from all
 ```
 
 :::tip
@@ -160,6 +169,8 @@ Global options:
 Available commands:
   create     very_good create <subcommand> <project-name> [arguments]
              Creates a new very good project in the specified directory.
+  dart       very_good dart <subcommand> [arguments]
+             Run Dart CLI commands.
   mcp        Start the MCP (Model Context Protocol) server. WARNING: This is an experimental package and may change or become unstable without notice. Use it with caution at your own risk.
   packages   Command for managing packages.
   test       Run tests in a Dart or Flutter project.

site/docs/templates/core.md

@@ -50,13 +50,20 @@ dart pub global activate very_good_cli
 
 Then, you can use the `very_good create flutter_app` command just like you would `flutter create`. If desired, can specify a custom org name at time of generation with the `--org` flag.
 
+:::tip
+Use `-o` or `--output-directory` to specify a custom output directory for the generated project.
+:::
+
 ```sh
 # Create a new Flutter app named my_app
 very_good create flutter_app my_app --desc "My new Flutter app"
 
 # Create a new Flutter app named my_app with a custom org
 very_good create flutter_app my_app --desc "My new Flutter app" --org "com.custom.org"
 
+# Create a new Flutter app named my_app with a custom application id
+very_good create flutter_app my_app --application-id "com.custom.app.id"
+
 # Create a new Flutter app named with the name of the current directory
 very_good create flutter_app . --desc "My new Flutter app"
 ```

site/docs/templates/dart_cli.md

@@ -10,13 +10,20 @@ This template is for a Dart Command-Line Interface.
 
 ## Usage
 
+:::tip
+Use `-o` or `--output-directory` to specify a custom output directory for the generated project.
+:::
+
 ```sh
 # Create a new Dart CLI application named my_dart_cli
 very_good create dart_cli my_dart_cli --desc "My new Dart CLI package"
 
 # Create a new Dart CLI application named my_dart_cli with a custom executable name
 very_good create dart_cli my_dart_cli --desc "My new Dart CLI package" --executable-name my_executable_name
 
+# Create a new Dart CLI application named my_dart_cli that is publishable
+very_good create dart_cli my_dart_cli --desc "My new Dart CLI package" --publishable
+
 # Create a new Dart CLI named with the name of the current directory
 very_good create dart_cli . --desc "My new Dart CLI package"
 ```

site/docs/templates/dart_pkg.md

@@ -8,6 +8,10 @@ This template is for a Dart package.
 
 ## Usage
 
+:::tip
+Use `-o` or `--output-directory` to specify a custom output directory for the generated project.
+:::
+
 ```sh
 # Create a new Dart package named my_dart_package
 very_good create dart_package my_dart_package --desc "My new Dart package"

site/docs/templates/docs_site.md

@@ -28,10 +28,17 @@ This template is powered by [Docusaurus][docusaurus_link] and comes with the fol
 
 ## Getting Started 🚀
 
+:::tip
+Use `-o` or `--output-directory` to specify a custom output directory for the generated project.
+:::
+
 ```sh
 # Create a new docs site named my_docs_site
 very_good create docs_site my_docs_site
 
+# Create a new docs site named my_docs_site with a custom org
+very_good create docs_site my_docs_site --org "my-custom-org"
+
 # Create a new docs site named with the name of the current directory
 very_good create docs_site .
 ```

site/docs/templates/federated_plugin.md

@@ -8,6 +8,10 @@ This template is for a plugin that follows the [federated plugin architecture][f
 
 ## Usage
 
+:::tip
+Use `-o` or `--output-directory` to specify a custom output directory for the generated project.
+:::
+
 ```sh
 # Create a new Flutter plugin named my_flutter_plugin (all platforms enabled)
 very_good create flutter_plugin my_flutter_plugin --desc "My new Flutter plugin"
@@ -31,6 +35,9 @@ very_good create flutter_plugin my_flutter_plugin --desc "My new Flutter plugin"
 
 # Create a new Flutter plugin named with the name of the current directory
 very_good create flutter_plugin . --desc "My new Flutter plugin" --platforms android,ios,web
+
+# Create a new Flutter plugin named my_flutter_plugin that is publishable
+very_good create flutter_plugin my_flutter_plugin --desc "My new Flutter plugin" --publishable
 ```
 
 [federated_plugin_docs]: https://docs.flutter.dev/development/packages-and-plugins/developing-packages#federated-plugins

site/docs/templates/flame_game.md

@@ -34,6 +34,10 @@ The values for platforms are: `android`, `ios`, `web`, `macos`, and `windows`.
 
 ## Usage
 
+:::tip
+Use `-o` or `--output-directory` to specify a custom output directory for the generated project.
+:::
+
 ```sh
 # Create a new Flame game named my_game
 very_good create flame_game my_game --desc "My new Flame game"