Stage the Flutter site

Before committing changes or reviewing a PR locally, it is important to stage the site and ensure everything works correctly. Follow these steps to stage the site:

1. Check for broken links

Run the following command to check for any unlinked or broken Markdown link references in the site output:

dart run dash_site check-link-references

Alternatively, to verify all links between pages on the site work:

dart run dash_site check-links

If any broken links are found, try to patch them or alert the user.

2. Sync code excerpts

Ensure that any changed code excerpts are properly run and synced to the Markdown files:

dart run dash_site refresh-excerpts

3. Update formatting

Update the formatting of the site examples and tools to ensure they follow the official Dart format:

dart run dash_site format-dart

4. Stage the site locally

Finally, serve a local development server of the site so the user can preview the changes:

dart run dash_site serve