Back to Dart Lang

DartPad

pkg/dartpad/README.md

3.13.0-275.0.dev1.8 KB
Original Source

DartPad

package:dartpad is a library for building web applications that enable users to prototype Dart and Flutter in the browser.

This package provides the functionality for running a Dart or Flutter development environment in the browser. By enabling you launch and communicate with:

  • A worker, a dart2wasm compiled Web Worker featuring:
    • An in-memory file system,
    • The Dart LSP server,
    • The Dart Development Compiler (DDC),
    • A subset of dart pub commands for dependency resolution.
  • A Sandbox, an isolated iframe containing bootstrap code necessary to:
    • Run, hot-reload and hot-restart DDC compiled Dart code, and,
    • Proxy console output and unhandled exceptions out of the iframe.

To build a custom dartpad-like experience, you simply have to launch the worker, connect the language server to your editor, compile code and tell the sandbox to run said code, while presenting console output to the user.

Assets

To launch a Web Worker, pre-compiled worker.wasm and associated assets are available inside web/ in package:dartpad. You must extract and host these files to provide an absolute URL for DartPad.create.

Example

dart
import 'package:dartpad/dartpad.dart';

Future<void> main() async {
  final dartpad = await DartPad.create(
    // Absolute URL for files in web/ folder of package:dartpad
    assetBaseUrl: Uri.base.resolve('web/'),
    sdkLocation: Uri.parse('dart/'), // relative to assetBaseUrl
  );

  final ws = await dartpad.createWorkspace();
  await ws.writeFileFromText(
    'main.dart',
    'void main() => print("hello world");',
  );
}

Limitations

As of writing there are no support for:

  • Build hooks,
  • Flutter plugins,
  • Flutter assets,
  • Code generation with build_runner.

It might be possible to support some of these features in the future.