TypeScript example proposal

examples/with-typescript/.gitignore

@@ -0,0 +1 @@
+**/*.js

examples/with-typescript/README.md

@@ -0,0 +1,22 @@
+# TypeScript Next.js example  
+This is a really simple project that show the usage of Next.js with TypeScript.  
+
+## How to use it?  
+```
+npm install  # to install dependencies
+npm run dev  # to compile TypeScript files and to run next.js  
+```  
+
+Output JS files are aside the related TypeScript ones.  
+
+## To fix  
+In tsconfig.json the options `jsx="react"` compiles JSX syntax into nested React.createElement calls.  
+This solution doesn't work well with some Next.js features like `next/head` or `next/link`.  
+The workaround is to create JS files that just return the mentioned module and require them from TSX files.  
+Like  
+
+```js
+import Link from 'next/link'
+
+export default Link
+```

examples/with-typescript/components/MyComponent.tsx

@@ -0,0 +1,6 @@
+import * as React from 'react'
+
+export default () =>
+  <div>
+    <p>This is my component</p>
+  </div>

examples/with-typescript/package.json

@@ -0,0 +1,13 @@
+{
+  "scripts": {
+    "dev": "concurrently \"tsc --watch\" next"
+  },
+  "dependencies": {
+    "next": "latest"
+  },
+  "devDependencies": {
+    "@types/react": "^15.0.1",
+    "concurrently": "^3.1.0",
+    "typescript": "^2.1.5"
+  }
+}

examples/with-typescript/pages/index.tsx

@@ -0,0 +1,8 @@
+import * as React from 'react'
+import MyComponent from '../components/MyComponent'
+
+export default () => 
+  <div>
+    <h1>Hello world</h1>
+    <MyComponent />
+  </div>

examples/with-typescript/tsconfig.json

@@ -0,0 +1,8 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "target": "es2015",
+        "jsx": "react",
+        "allowJs": true
+    }
+}