## File: README.md

# Dart

## An approachable, portable, and productive language for high-quality apps on any platform

Dart is:

  * **Approachable**:
  Develop with a strongly typed programming language that is consistent,
  concise, and offers modern language features like null safety and patterns.

  * **Portable**:
  Compile to ARM, x64, or RISC-V machine code for mobile, desktop, and backend.
  Compile to JavaScript or WebAssembly for the web.

  * **Productive**:
  Make changes iteratively: use hot reload to see the result instantly in your running app.
  Diagnose app issues using [DevTools](https://dart.dev/tools/dart-devtools).

Dart's flexible compiler technology lets you run Dart code in different ways,
depending on your target platform and goals:

  * **Dart Native**: For programs targeting devices (mobile, desktop, server, and more),
  Dart Native includes both a Dart VM with JIT (just-in-time) compilation and an
  AOT (ahead-of-time) compiler for producing machine code.

  * **Dart Web**: For programs targeting the web, Dart Web includes both a development time
  compiler (dartdevc) and a production time compiler (dart2js).  



## License & patents

Dart is free and open source.

See [LICENSE][license] and [PATENT_GRANT][patent_grant].

## Using Dart

Visit [dart.dev][website] to learn more about the
[language][lang], [tools][tools], and to find
[codelabs][codelabs].

Browse [pub.dev][pubsite] for more packages and libraries contributed
by the community and the Dart team.

Our API reference documentation is published at [api.dart.dev](https://api.dart.dev),
based on the stable release. (We also publish docs from our 
[beta](https://api.dart.dev/beta) and [dev](https://api.dart.dev/dev) channels,
as well as from the [primary development branch](https://api.dart.dev/be)).

## Building Dart

If you want to build Dart yourself, here is a guide to
[getting the source, preparing your machine to build the SDK, and building][building].

There are more documents in our repo at [docs](https://github.com/dart-lang/sdk/tree/main/docs).

## Contributing to Dart

The easiest way to contribute to Dart is to [file issues][issues].

You can also contribute patches, as described in [Contributing][contrib].

## Roadmap

Future plans for Dart are included in the combined Dart and Flutter
[roadmap][roadmap] on the Flutter wiki.

[building]: https://github.com/dart-lang/sdk/blob/main/docs/Building.md
[codelabs]: https://dart.dev/codelabs
[contrib]: https://github.com/dart-lang/sdk/blob/main/CONTRIBUTING.md
[issues]: https://github.com/dart-lang/sdk/issues
[lang]: https://dart.dev/guides/language/language-tour
[license]: https://github.com/dart-lang/sdk/blob/main/LICENSE
[patent_grant]: https://github.com/dart-lang/sdk/blob/main/PATENT_GRANT
[pubsite]: https://pub.dev
[repo]: https://github.com/dart-lang/sdk
[roadmap]: https://github.com/flutter/flutter/blob/master/docs/roadmap/Roadmap.md
[tools]: https://dart.dev/tools
[website]: https://dart.dev

---

## File: docs/README.md

Welcome to the developer documentation for the Dart SDK!

[Contributions](../CONTRIBUTING.md) welcome! Please help us keep these docs
up-to-date.

## Important pages

Important pages include:

- [Building the SDK](Building.md)
- [Filing Dart issues](Filing-Dart-issues.md)
- Workarounds for [Flutter Pinned Packages](Flutter-Pinned-Packages.md)
- [How the issue tracker works](How-the-issue-tracker-works.md)
- [Testing](Testing.md)

Also, check out the combined
[Dart and Flutter roadmap](https://github.com/flutter/flutter/blob/master/docs/roadmap/Roadmap.md)
on the Flutter wiki.

## Process pages

Various process pages include:

- [Dart SDK breaking change process](process/breaking-changes.md)
- [Dart SDK process for changes behind experimental flags](process/experimental-flags.md)
- [Language Versioning and Experiments](process/language-versions-and-experiments.md)

## Contributing

Contributions welcome via Gerrit CLs or GitHub PRs. See our
[contributing](../CONTRIBUTING.md) doc for more information.

Contributions could include helping to keep pages up-to-date, adding additional
context to this main page, or re-organizing the documentation.

## Google Summer of Code

Interested in the latest on our Google Summer of Code projects? See
[Google Summer of Code 2024](gsoc/Dart-GSoC-2024-Project-Ideas.md).