diff --git a/src/pages/developing/frameworks/web-components.mdx b/src/pages/developing/frameworks/web-components.mdx
new file mode 100644
index 00000000000..de64de2e5ee
--- /dev/null
+++ b/src/pages/developing/frameworks/web-components.mdx
@@ -0,0 +1,185 @@
+---
+title: Frameworks
+description:
+ The Carbon Design System is built React first. We also support core parts of
+ the system in vanilla JS, Angular, Vue, Svelte, and web components.
+tabs:
+ [
+ 'React',
+ 'Vanilla',
+ 'Angular',
+ 'Vue',
+ 'Svelte',
+ 'Web Components',
+ 'Other frameworks',
+ ]
+---
+
+
+
+The library provides front-end developers and engineers a collection of reusable
+web components to build websites and user interfaces. Adopting the library
+enables developers to use consistent markup, styles, and behavior in prototype
+and production work.
+
+This library uses Custom Elements v1 and Shadow DOM v1 specs.
+
+
+
+
+
+The web components library is maintained by members of the Carbon community. For
+support, contact the
+[Carbon Web Components team](https://github.com/carbon-design-system/carbon-web-components/issues/new/choose).
+
+
+
+## Resources
+
+
+
+
+
+![Storybook icon](images/storybook.svg)
+
+
+
+
+
+
+
+
+
+
+## Getting started
+
+To install `carbon-web-components` in your project, you will need to run the
+following command using [npm](https://www.npmjs.com/):
+
+```bash
+npm install -S carbon-web-components carbon-components lit-html lit-element
+```
+
+If you prefer [Yarn](https://yarnpkg.com/en/), use the following command
+instead:
+
+```bash
+yarn add carbon-web-components carbon-components lit-html lit-element
+```
+
+### Basic usage
+
+Our example at [CodeSandbox](https://codesandbox.io) shows the most basic usage:
+
+[![Edit carbon-web-components](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/github/carbon-design-system/carbon-web-components/tree/master/examples/codesandbox/basic)
+
+The first thing you need to do is **set up a module bundler** to resolve
+ECMAScript `import`s. The above example uses [Webpack](https://webpack.js.org) but you
+can use other bundlers like [Rollup](https://rollupjs.org/) too.
+
+Once you set up a module bundler, you can start importing our component modules,
+for example:
+
+```javascript
+import 'carbon-web-components/es/components/dropdown/dropdown.js';
+import 'carbon-web-components/es/components/dropdown/dropdown-item.js';
+```
+
+Once you've imported the component modules, you can use our components in the same manner as native HTML
+tags, for example:
+
+```html
+
+ Option 1
+ Option 2
+ Option 3
+ Option 4
+ Option 5
+
+```
+
+If you just want to try our components for demonstrations and so on, you can use
+CDNs that support module mapping (for example, [JSPM](https://jspm.org)). With
+CDNs, you can import just our modules in `
+
+
+
+
+
+ Option 1
+ Option 2
+ Option 3
+ Option 4
+ Option 5
+
+
+
+