diff --git a/README.md b/README.md
index 4a8319c..8a9b1ff 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,12 @@
+# This package has been renamed to 'html'.
+
+**Future releases of this package will happen in the `html` package.**
+
+**To continue using `html5lib` without deprecation warnings, change your pubspec
+to depend on `html5lib: '<=0.12.0'`.**
+
+**See the [html package](https://pub.dartlang.org/packages/html) for details.**
+
 html5lib in Pure Dart
 =====================
 
diff --git a/lib/dom.dart b/lib/dom.dart
index 3c5b332..f85b243 100644
--- a/lib/dom.dart
+++ b/lib/dom.dart
@@ -1,5 +1,8 @@
 /// A simple tree API that results from parsing html. Intended to be compatible
 /// with dart:html, but it is missing many types and APIs.
+///
+/// **DEPRECATED**. This package has been renamed `html`.
+@deprecated('Use the "html" package instead.')
 library dom;
 
 // TODO(jmesserly): lots to do here. Originally I wanted to generate this using
diff --git a/lib/dom_parsing.dart b/lib/dom_parsing.dart
index 527d9a6..ab2c660 100644
--- a/lib/dom_parsing.dart
+++ b/lib/dom_parsing.dart
@@ -1,5 +1,8 @@
 /// This library contains extra APIs that aren't in the DOM, but are useful
 /// when interacting with the parse tree.
+///
+/// **DEPRECATED**. This package has been renamed `html`.
+@deprecated('Use the "html" package instead.')
 library dom_parsing;
 
 import 'dom.dart';
diff --git a/lib/parser.dart b/lib/parser.dart
index ded6a74..24f584e 100644
--- a/lib/parser.dart
+++ b/lib/parser.dart
@@ -11,6 +11,9 @@
 ///
 /// The resulting document you get back has a DOM-like API for easy tree
 /// traversal and manipulation.
+///
+/// **DEPRECATED**. This package has been renamed `html`.
+@deprecated('Use the "html" package instead.')
 library parser;
 
 import 'dart:collection';
diff --git a/lib/parser_console.dart b/lib/parser_console.dart
index 515f891..ea6db76 100644
--- a/lib/parser_console.dart
+++ b/lib/parser_console.dart
@@ -1,6 +1,9 @@
 /// This library adds `dart:io` support to the HTML5 parser. Call
 /// [initDartIOSupport] before calling the [parse] methods and they will accept
 /// a [RandomAccessFile] as input, in addition to the other input types.
+///
+/// **DEPRECATED**. This package has been renamed `html`.
+@deprecated('Use the "html" package instead.')
 library parser_console;
 
 import 'dart:io';
diff --git a/pubspec.yaml b/pubspec.yaml
index 2be7677..953e40c 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,5 +1,5 @@
 name: html5lib
-version: 0.12.0
+version: 0.12.0+1
 author: Dart Team <misc@dartlang.org>
 description: A library for working with HTML documents.
 homepage: http://pub.dartlang.org/packages/html5lib