diff --git a/README.md b/README.md
index 2d3b266..d353c64 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# `Turborepo` Vite starter
+# `Turborepo` Vite & Tailwind starter
This is an official starter Turborepo.
@@ -8,18 +8,35 @@ This Turborepo includes the following packages and apps:
### Apps and Packages
-- `docs`: a vanilla [vite](https://vitejs.dev) ts app
-- `web`: another vanilla [vite](https://vitejs.dev) ts app
-- `ui`: a stub component & utility library shared by both `web` and `docs` applications
+- `web`: a react [vite](https://vitejs.dev) ts app with [Tailwind CSS](https://tailwindcss.com/)
+- `ui`: a stub React component library with [Tailwind CSS](https://tailwindcss.com/) shared by `web`
- `eslint-config-custom`: shared `eslint` configurations
- `tsconfig`: `tsconfig.json`s used throughout the monorepo
Each package and app is 100% [TypeScript](https://www.typescriptlang.org/).
+### Building packages/ui
+
+This example is setup to build `packages/ui` and output the transpiled source and compiled styles to `dist/`. This was chosen to make sharing one `tailwind.config.js` as easy as possible, and to ensure only the CSS that is used by the current application and its dependencies is generated.
+
+Another option is to consume `packages/ui` directly from source without building. If using this option, you will need to update your `tailwind.config.js` to be aware of your package locations, so it can find all usages of the `tailwindcss` class names.
+
+For example, in [tailwind.config.js](packages/tailwind-config/tailwind.config.js):
+
+```js
+ content: [
+ // app content
+ `src/**/*.{js,ts,jsx,tsx}`,
+ // include packages if not transpiling
+ "../../packages/**/*.{js,ts,jsx,tsx}",
+ ],
+```
+
### Utilities
This Turborepo has some additional tools already setup for you:
+- [Tailwind CSS](https://tailwindcss.com/) for styles
- [TypeScript](https://www.typescriptlang.org/) for static type checking
- [ESLint](https://eslint.org/) for code linting
- [Jest](https://jestjs.io) test runner for all things JavaScript
diff --git a/apps/docs/.eslintrc.cjs b/apps/docs/.eslintrc.cjs
deleted file mode 100644
index c8df607..0000000
--- a/apps/docs/.eslintrc.cjs
+++ /dev/null
@@ -1,4 +0,0 @@
-module.exports = {
- root: true,
- extends: ["custom"],
-};
diff --git a/apps/docs/favicon.svg b/apps/docs/favicon.svg
deleted file mode 100644
index de4aedd..0000000
--- a/apps/docs/favicon.svg
+++ /dev/null
@@ -1,15 +0,0 @@
-
diff --git a/apps/docs/index.html b/apps/docs/index.html
deleted file mode 100644
index f86e483..0000000
--- a/apps/docs/index.html
+++ /dev/null
@@ -1,13 +0,0 @@
-
-
-
-
-
-
- Vite + TS
-
-
-
-
-
-
diff --git a/apps/docs/package.json b/apps/docs/package.json
deleted file mode 100644
index fd0719e..0000000
--- a/apps/docs/package.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
- "name": "docs",
- "private": true,
- "version": "0.0.0",
- "type": "module",
- "scripts": {
- "dev": "vite",
- "build": "tsc && vite build",
- "preview": "vite preview",
- "lint": "TIMING=1 eslint \"src/**/*.ts\""
- },
- "dependencies": {
- "ui": "workspace:*"
- },
- "devDependencies": {
- "eslint": "^7.32.0",
- "eslint-config-custom": "workspace:*",
- "tsconfig": "workspace:*",
- "typescript": "^4.9.4",
- "vite": "^4.0.3"
- }
-}
diff --git a/apps/docs/public/vite.svg b/apps/docs/public/vite.svg
deleted file mode 100644
index e7b8dfb..0000000
--- a/apps/docs/public/vite.svg
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/apps/docs/src/main.ts b/apps/docs/src/main.ts
deleted file mode 100644
index 85103f5..0000000
--- a/apps/docs/src/main.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-import "./style.css";
-import typescriptLogo from "./typescript.svg";
-import { Header, Counter, setupCounter } from "ui";
-
-document.querySelector("#app")!.innerHTML = `
-
-