site-www

# <img src="https://github.com/dart-lang/site-shared/blob/main/src/_assets/image/dart/logo/64.png" alt="Dart" width="28" height="28"/> The Dart language site (dart.dev)

[![Build Status SVG][]][Repo on GitHub Actions]
[![OpenSSF Scorecard SVG][]][Scorecard Results]

The documentation site for the [Dart programming language](https://dart.dev), 
built with [Jaspr][] and hosted on [Firebase][].

We welcome contributions of all kinds!
To set up the site locally, follow the
below guidelines on [Building the site](#build-the-site).
To learn more about contributing to this repository,
check out the [Contributing guidelines](CONTRIBUTING.md).

## Getting started

Start by looking for an [issue](https://github.com/dart-lang/site-www/issues)
that catches your interest, or create an issue with your proposed change.
Consider adding a comment to let everyone know that you're working on it, and
feel free to ask any questions you have on the same issue.

To update this site, fork the repo, make your changes,
and generate a pull request.
For small, contained changes (such as style and typo fixes),
you probably don't need to build this site.
Often you can make changes using the GitHub UI.
We can stage the changes automatically in your pull request.

If your change involves code samples, adds/removes pages, or affects navigation,
do consider building and testing your work before submitting.

If you want or need to build the site, follow the steps below.

## Build the site

For changes beyond simple text and CSS tweaks,
we recommend running the site locally to
enable an edit-refresh cycle. 

### Get the prerequisites

Install the following tools to build and develop the site:

#### Dart

The latest stable release of Dart is required to build the site
and run its tooling. This can be the Dart included in the Flutter SDK.
If you don't have Dart or need to update, follow the
instructions at [Get the Dart SDK][].

If you already have Dart installed, verify it's on your path
and already the latest stable version:

```terminal
dart --version
```

### Clone this repo

If you're not a member of the Dart organization,
we recommend you [create a fork][] of this repo under your own account,
and then submit a PR from that fork.

Once you have a fork (or you're a Dart org member),
clone the repository with `git clone`:

```bash
git clone https://github.com/dart-lang/site-www.git
```

[create a fork]: https://docs.github.com/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo

## Set up your local environment and serve changes

Before you continue setting up the site infrastructure,
verify the correct version of Dart is set up and available by
following the instructions in [Get the prerequisites](#get-the-prerequisites).

1. _Optional:_ After cloning the repo,
   create a branch for your changes:

   ```terminal
   git checkout -b <BRANCH_NAME>
   ```

2. From the root directory of the repository,
   fetch the site's Dart dependencies.

   ```terminal