# Build a web app with Dart

> Get started writing web apps in Dart.



This page describes the steps to start developing **web-only** apps with Dart.
If you want to write a **multi-platform** app, then
[try Flutter.](https://flutter.dev/web)

Before you begin, ensure you're comfortable with Dart basics
by reading the [Introduction to Dart](/language).
Then follow the steps below to create a small web app with Dart.

## 1. Install Dart {:#install-dart}

To develop Dart apps, you need the Dart SDK.
To continue with this guide,
either [download the Dart SDK][dart-download] or
[install Flutter][flutter-download],
which includes the full Dart SDK.

[dart-download]: /get-dart
[flutter-download]: https://docs.flutter.dev/get-started/install

## 2. Get CLI tools or an IDE (or both) {:#tools}

<i class="material-symbols">terminal</i>
If you like to use the command line, install the [`webdev`][] package:

```console
$ dart pub global activate webdev
```

<i class="material-symbols">web</i>
Although using an IDE is optional, we highly recommend using one.
For a list of available IDEs, see the
[overview of editors & debuggers][].

[overview of editors & debuggers]: /tools#editors

## 3. Create a web app {:#create}

<i class="material-symbols">terminal</i>
To create a web app from the command line,
use the [`dart create`][] command with the `web` template:

```console
$ dart create -t web quickstart
```

<i class="material-symbols">web</i>
To create the same web app from an IDE that has Dart integration,
[create a project](https://flutter.dev/tools/vs-code#creating-a-new-project)
using the template named **Bare-bones Web App**.

The web app template imports [`package:web`][], Dart's powerful and concise web
interop solution built for the modern web. To learn more about it, check out the
[web interop overview](/interop/js-interop/package-web).

[`dart create`]: /tools/dart-create
[`package:web`]: https://pub.dev/packages/web

## 4. Run the app {:#run}

<i class="material-symbols">terminal</i>
To run the app from the command line,
use [`webdev`][] to build and serve the app:

```console
$ cd quickstart
$ webdev serve
```

<i class="material-symbols">web</i>
Or run the app from your IDE.

To view your app, use the Chrome browser
to visit the app's URL—for example,
[`localhost:8080`](http://localhost:8080).

Whether you use an IDE or the command line,
[`webdev serve`][] builds and serves your app
using the development JavaScript compiler.
Startup is slowest the first time the
development compiler builds and serves your app.
After that, assets are cached on disk and incremental builds are much faster.

Once your app has compiled, the browser should display
"Your Dart app is running."

![Launched bare-bones app](/assets/img/bare-bones-web-app.png){:width="500"}

[`webdev serve`]: /tools/webdev#serve

## 5. Add custom code to the app {:#add-code}

Let's customize the app you just created.

1. Copy the `thingsToDo()` function from the following snippet
   to the `web/main.dart` file:

   ```dart
   Iterable<String> thingsToDo() sync* {
     const actions = ['Walk', 'Wash', 'Feed'];
     const pets = ['cats', 'dogs'];

     for (final action in actions) {
       for (final pet in pets) {
         if (pet != 'cats' || action == 'Feed') {
           yield '$action the $pet';
         }
       }
     }
   }
   ```

2. Add the `newLI()` function (as shown below).
   It creates a new `LIElement` containing the specified `String`.

   ```dart highlightLines=3-5
   Iterable<String> thingsToDo() sync* { /* ... */ }

   web.HTMLLIElement newLI(String itemText) =>
       (web.document.createElement('li') as web.HTMLLIElement)
         ..textContent = itemText;

   void main() { /* ... */ }
   ```

3. In the `main()` function, append content to the `output` element
   using `appendChild` and the values from `thingsToDo()`:

   ```dart highlightLines=9-11
   Iterable<String> thingsToDo() sync* { /* ... */ }

   web.HTMLLIElement newLI(String itemText) =>
       (web.document.createElement('li') as web.HTMLLIElement)
         ..textContent = itemText;

   void main() {
     final output = web.document.querySelector('#output');
     for (final item in thingsToDo()) {
       output?.appendChild(newLI(item));
     }
   }
   ```

4. Save your changes.

5. The `webdev` tool automatically rebuilds your app.
   Refresh the app's browser window.
   Now your simple Dart app has a todo list!
   It should look something like this:<br>
   ![Running the revised app](/assets/img/bare-bones-todo.png){:width="500"}

6. Optionally, improve the formatting by editing `web/styles.css`,
   then reload the app to check your changes.

   ```css highlightLines=3
   #output {
     padding: 20px;
     text-align: left;
   }
   ```


## 6. Use Dart DevTools to inspect the app {:#devtools}

Use Dart DevTools to set breakpoints, view values and types,
and step through your app's Dart code.
For setup details and a walkthrough, see
[Debugging Dart Web Apps][].

[Debugging Dart Web Apps]: /web/debugging

## 7. Build and deploy your web app {:#deploy}

To run your web app outside your development environment,
you'll need to build and deploy it.
To learn more about deploying Dart web apps,
check out [Web deployment][].

[Web deployment]: /web/deployment

## What next?

Check out these resources:

* Dart language, libraries, and conventions
  * [Language tour](/language)
  * [Core library walkthrough](/libraries)
  * [Effective Dart](/effective-dart)
* Web development
  * [JavaScript interoperability](/interop/js-interop)
  * [Web libraries and packages](/web/libraries)
  * [`package:web` overview](/interop/js-interop/package-web)
  * [Introduction to the DOM][]

If you get stuck, find help at [Community and support.](/community)

[Introduction to the DOM]: https://developer.mozilla.org/docs/Web/API/Document_Object_Model/Introduction

[`webdev`]: /tools/webdev

