+
+
diff --git a/packages/website/src/docs/docs.11tydata.json b/packages/website/src/docs/docs.11tydata.json
new file mode 100644
index 0000000000..8ab4cd9fb4
--- /dev/null
+++ b/packages/website/src/docs/docs.11tydata.json
@@ -0,0 +1 @@
+{ "layout": "layouts/docs.njk" }
diff --git a/packages/website/src/docs/index.md b/packages/website/src/docs/index.md
new file mode 100644
index 0000000000..69873f9b14
--- /dev/null
+++ b/packages/website/src/docs/index.md
@@ -0,0 +1,5 @@
+---
+title: Cadl Docummentation
+---
+
+# Cadl Documentation
diff --git a/packages/website/src/docs/installation.md b/packages/website/src/docs/installation.md
new file mode 100644
index 0000000000..3cdc87482d
--- /dev/null
+++ b/packages/website/src/docs/installation.md
@@ -0,0 +1,54 @@
+---
+eleventyNavigation:
+ key: Installation
+---
+
+# Installation
+
+## Requirements
+
+Install [Node.js 16 LTS](https://nodejs.org/en/download/) and ensure you are able to run the `npm` command in a command prompt:
+
+```bash
+npm --version
+```
+
+It is recommended to have npm 7+. To update npm run `npm install -g npm`
+
+## Install cadl compiler
+
+First step is to install the cadl compiler/cli
+
+```bash
+npm install -g @cadl-lang/compiler
+```
+
+## Create first Cadl Project
+
+To get your first Cadl project started run in a fresh directory
+
+```bash
+cadl init
+```
+
+This will prompt you with a few question, pick the `Generic Rest API` template.
+
+Next, you can install the dependencies
+
+```bash
+cadl install
+```
+
+You should now have a basic Cadl project setup with a structure looking like
+
+```
+package.json # Package manfifest defining your cadl project as a node package.
+cadl-project.yaml # Cadl project configuration letting you configure emitters, emitter options, compiler options, etc.
+main.cadl # Cadl entrypoint
+```
+
+## Compile project
+
+```bash
+cadl compile .
+```
diff --git a/packages/website/src/docs/language-basics/import.md b/packages/website/src/docs/language-basics/import.md
new file mode 100644
index 0000000000..2976d99bfd
--- /dev/null
+++ b/packages/website/src/docs/language-basics/import.md
@@ -0,0 +1,57 @@
+---
+eleventyNavigation:
+ key: Import
+ parent: Language Basics
+---
+
+# Import
+
+Imports add files or libraries to your Cadl program. When you compile a Cadl file, you provide a path to your root Cadl file, by convention called "main.cadl". From there, any files you import are added to your program. If you import a directory, Cadl will look for a `main.cadl` file inside that directory.
+
+The path you import must either begin with `"./"` or `"../"` or otherwise be an absolute path. The path must either refer to a directory, or else have an extension of either ".cadl" or ".js". The following demonstrates how to use imports to assemble a Cadl program from multiple files:
+
+## Import Cadl file
+
+```cadl
+import "./models/foo.cadl";
+
+```
+
+## Import Js file
+
+```cadl
+import "./decorators.js";
+
+```
+
+## Import a library
+
+The import value can be name one of the package dependencies. In that case cadl will lookup for the `package.json` file and check the `cadlMain` entry (or default to `main` if absent) to decide what is the library entrypoint to load.
+
+```cadl
+import "@cadl-lang/rest";
+
+```
+
+```json
+// ./node_modules/@cadl-lang/rest/package.json
+{
+ "cadlMain": "./lib/main.cadl"
+}
+```
+
+which result in `./node_modules/@cadl-lang/rest/lib/main.cadl` to be imported
+
+## Import a directory
+
+If the import value is a directory it will lookup if that directoy is a node package and follow the npm package [lookup logic](#import-a-library) or if the directory contains a `main.cadl`.
+
+```cadl
+import "./models"; // same as `import "./models/main.cadl";
+
+```
+
+```cadl
+import "./path/to/local/module"; // Assuming this path is a cadl package, it will load it using the cadlMain file.
+
+```
diff --git a/packages/website/src/docs/language-basics/index.md b/packages/website/src/docs/language-basics/index.md
new file mode 100644
index 0000000000..49db542f62
--- /dev/null
+++ b/packages/website/src/docs/language-basics/index.md
@@ -0,0 +1,6 @@
+---
+eleventyNavigation:
+ key: Language Basics
+---
+
+# Language Overview
diff --git a/packages/website/src/docs/language-basics/record.md b/packages/website/src/docs/language-basics/record.md
new file mode 100644
index 0000000000..b9d447617b
--- /dev/null
+++ b/packages/website/src/docs/language-basics/record.md
@@ -0,0 +1,7 @@
+---
+eleventyNavigation:
+ key: Record
+ parent: Language Basics
+---
+
+# Record
diff --git a/packages/website/src/index.md b/packages/website/src/index.md
new file mode 100644
index 0000000000..ebbddcb6ba
--- /dev/null
+++ b/packages/website/src/index.md
@@ -0,0 +1,11 @@
+---
+title: Cadl
+layout: "layouts/main.njk"
+---
+
+# Cadl
+
+Cadl is a language for describing cloud service APIs and generating other API
+description languages, client and service code, documentation, and other assets.
+Cadl provides highly extensible core language primitives that can describe API
+shapes common among REST, GraphQL, gRPC, and other protocols.
diff --git a/packages/website/src/playground/index.md b/packages/website/src/playground/index.md
new file mode 100644
index 0000000000..066d835af0
--- /dev/null
+++ b/packages/website/src/playground/index.md
@@ -0,0 +1,11 @@
+---
+title: Cadl Playground.
+permalink: play/index.html
+layout: "layouts/base.njk"
+---
+
+
diff --git a/rush.json b/rush.json
index 961bbec588..8c0a55ce66 100644
--- a/rush.json
+++ b/rush.json
@@ -156,6 +156,12 @@
"reviewCategory": "production",
"shouldPublish": false
},
+ {
+ "packageName": "@cadl-lang/website",
+ "projectFolder": "packages/website",
+ "reviewCategory": "production",
+ "shouldPublish": false
+ },
{
"packageName": "@cadl-lang/bundler",
"projectFolder": "packages/bundler",