diff --git a/README.md b/README.md
deleted file mode 120000
index 1717ef8..0000000
--- a/README.md
+++ /dev/null
@@ -1 +0,0 @@
-packages/polydev/README.md
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ace5280
--- /dev/null
+++ b/README.md
@@ -0,0 +1,145 @@
+
+
+> Faster, route-centric development for [Node.js][node] apps with built-in
+> [Hot Module Replacement][hmr].
+>
+> 
+
+## Rationale
+
+As your project grows, **working on a large or monolithic [Node.js][node] app gets slower**:
+
+- Working on _part_ of the app means running the _entire_ app.
+- The `require` tree grows so large it can take several seconds to start the server.
+- Restarting the server on every change impedes development.
+- Middleware for projects like [Next.js][next] & [Storybook][storybook] are expensive
+ to restart with each change.
+- Tools like [concurrently][concurrently], [nodemon][nodemon], & [piping][piping] still
+ run the entire app.
+- You shouldn't waste time in the terminal hitting Ctrl-C and restarting.
+
+## Features
+
+- Fast startup.
+- [Hot Module Replacement][hmr] built-in.
+- Run only the parts of your app that's requested.
+- Supports [yarn workspaces][workspaces].
+- Pretty `404` screens with the option to create the missing route.
+- Pretty `500` screens, so you spend less time in the terminal.
+- Iterative adoption, so it's easy to get started.
+
+## Quick Started
+
+1. Install
+
+ ```shell
+ yarn add polydev --dev
+ ```
+
+2. Run `polydev`
+
+ ```shell
+ yarn run polydev --open
+ ```
+
+For customizing the `node` runtime, you can use `NODE_OPTIONS`.
+
+For example, [TypeScript][typescript] can be enabled via [ts-node][ts-node]:
+
+```shell
+NODE_OPTIONS="--require ts-node/register" polydev
+```
+
+## Defining `routes`
+
+The `routes` folder is similar to Old-Time™ HTML & PHP, where
+**folders mirror the URL structure**, followed by an `index.js` file:
+
+- `routes/`
+
+ - `page/[id]/index.js`
+
+ _Has access to `req.params.id` for [/page/123](http://localhost:3000/page/123)._
+
+ - `contact-us/`
+
+ - `index.get.js`
+ - `index.post.js`
+
+ - `posts/index.*.js`
+
+ _Responds to both `GET` & `POST` for [/posts/\*](http://localhost:3000/posts)._
+
+ - `index.js`
+
+ _Responds to both `GET` & `POST` for [/](http://localhost:3000/)._
+
+### Route Handlers
+
+Route handlers can be any of the following:
+
+1. Functional middleware:
+
+ ```js
+ module.exports = (req, res) => {
+ res.send("Howdy there!")
+ }
+ ```
+
+2. Express apps:
+
+ ```js
+ const express = require("express")
+
+ module.exports = express().get("/", (req, res) => {
+ res.send(`Howdy from ${req.path}!`)
+ })
+ ```
+
+3. A [yarn workspace][workspaces] package:
+
+ ```js
+ module.exports = require("my-package-name")
+ ```
+
+4. A `package.json` path:
+
+ ```js
+ module.exports = require.resolve("my-app/package.json")
+ ```
+
+ These are considered stand-alone apps that will be ran via `yarn dev` or `yarn start` (whichever exists) for development only.
+
+ This is good for when you want to have a separate API server open on `process.env.PORT` that's not part of your application.
+
+## Roadmap
+
+- [ ] [Reload browser on double-save](/../../issues/1)
+- [ ] [Loading screen, for slow routes](/../../issues/2)
+- [ ] [Option to install missing modules](/../../issues/3)
+- [ ] [ESM support](/../../issues/4)
+- [x] [TypeScript support](/../../issues/5)
+- [ ] [Better errors for broken routes/modules](/../../issues/6)
+- [ ] [Storybook example](/../../issues/7)
+- [ ] [View All][issues]
+
+## Contributing
+
+> See [CONTRIBUTING.md](/CONTRIBUTING.md).
+
+## Author
+
+- [Eric Clemmons][twitter]
+
+[concurrently]: https://github.com/kimmobrunfeldt/concurrently
+[hmr]: https://github.com/sidorares/hot-module-replacement
+[issues]: https://github.com/ericclemmons/polydev/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
+[next]: https://github.com/zeit/next.js/
+[node]: https://nodejs.org/
+[nodemon]: https://github.com/remy/nodemon
+[piping]: https://www.npmjs.com/package/piping
+[storybook]: https://github.com/storybooks/storybook
+[ts-node]: https://github.com/TypeStrong/ts-node
+[typescript]: https://www.typescriptlang.org/
+[twitter]: https://twitter.com/ericclemmons
+[workspaces]: https://yarnpkg.com/en/docs/workspaces
diff --git a/packages/polydev/README.md b/packages/polydev/README.md
index 3c5cae4..ace5280 100644
--- a/packages/polydev/README.md
+++ b/packages/polydev/README.md
@@ -42,6 +42,14 @@ As your project grows, **working on a large or monolithic [Node.js][node] app ge
yarn run polydev --open
```
+For customizing the `node` runtime, you can use `NODE_OPTIONS`.
+
+For example, [TypeScript][typescript] can be enabled via [ts-node][ts-node]:
+
+```shell
+NODE_OPTIONS="--require ts-node/register" polydev
+```
+
## Defining `routes`
The `routes` folder is similar to Old-Time™ HTML & PHP, where
@@ -110,7 +118,7 @@ Route handlers can be any of the following:
- [ ] [Loading screen, for slow routes](/../../issues/2)
- [ ] [Option to install missing modules](/../../issues/3)
- [ ] [ESM support](/../../issues/4)
-- [ ] [TypeScript support](/../../issues/5)
+- [x] [TypeScript support](/../../issues/5)
- [ ] [Better errors for broken routes/modules](/../../issues/6)
- [ ] [Storybook example](/../../issues/7)
- [ ] [View All][issues]
@@ -131,5 +139,7 @@ Route handlers can be any of the following:
[nodemon]: https://github.com/remy/nodemon
[piping]: https://www.npmjs.com/package/piping
[storybook]: https://github.com/storybooks/storybook
+[ts-node]: https://github.com/TypeStrong/ts-node
+[typescript]: https://www.typescriptlang.org/
[twitter]: https://twitter.com/ericclemmons
[workspaces]: https://yarnpkg.com/en/docs/workspaces
diff --git a/packages/polydev/src/middleware/router/createRouterFromFiles.js b/packages/polydev/src/middleware/router/createRouterFromFiles.js
index 0610873..887c799 100644
--- a/packages/polydev/src/middleware/router/createRouterFromFiles.js
+++ b/packages/polydev/src/middleware/router/createRouterFromFiles.js
@@ -4,7 +4,7 @@ const path = require("path")
const handle = require("./handle")
// Match index[.*|get|post].js
-const REGEXP_INDEX = /^index(?:\.(\*|get|post))?\.js$/
+const REGEXP_INDEX = /^index(?:\.(\*|get|post))?\.(?:j|t)s$/
const REGEXP_PARAM = /\[([a-zA-Z0-9-]+)\]/g
const REGEXP_PARAM_REPLACE = ":$1"
const REGEXP_TRAILING_SLASH = /\/+$/
diff --git a/packages/typescript-example/index.ts b/packages/typescript-example/index.ts
new file mode 100644
index 0000000..d971a03
--- /dev/null
+++ b/packages/typescript-example/index.ts
@@ -0,0 +1,30 @@
+import { Request, Response } from "express"
+
+let hits = 0
+
+export default (req: Request, res: Response) => {
+ hits++
+
+ res.send(`
+
+
+
+
+
+
+
+