# great-docs timings


Show page-level build timings from the last build.


``` bash
great-docs timings [OPTIONS]
```


Reads the build-timings.json artifact generated during `great-docs build` and displays per-page render durations as a sorted table. Pages are listed slowest-first to help identify bottlenecks.

Run `great-docs build` first to generate the timing data.


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Usage: great-docs timings [OPTIONS]

      Show page-level build timings from the last build.

      Reads the build-timings.json artifact generated during 'great-docs build'
      and displays per-page render durations as a sorted table. Pages are listed
      slowest-first to help identify bottlenecks.

      Run 'great-docs build' first to generate the timing data.

      Examples:
        great-docs timings
        great-docs timings --top 10
        great-docs timings --version 0.10
        great-docs timings --output-dir ./public
        great-docs timings --json

    Options:
      --project-path DIRECTORY  Path to your project root directory (default:
                                current directory)
      --top INTEGER             Show only the N slowest pages.
      --version TEXT            Show timings for a specific version only (multi-
                                version builds).
      --json                    Output raw JSON instead of a table.
      --output-dir DIRECTORY    Path to the build output directory (if different
                                from default _site).
      --help                    Show this message and exit.


# Options


`--project-path: DIRECTORY`  
Path to your project root directory (default: current directory)

`--top: INTEGER`  
Show only the N slowest pages.

`--version: TEXT`  
Show timings for a specific version only (multi-version builds).

`--json`  
Output raw JSON instead of a table.

`--output-dir: DIRECTORY`  
Path to the build output directory (if different from default \_site).


# Examples

``` bash
  great-docs timings
  great-docs timings --top 10
  great-docs timings --version 0.10
  great-docs timings --output-dir ./public
  great-docs timings --json
```