2 files changed, 46 insertions, 0 deletions

diff --git a/support/doc/development/lib.md b/support/doc/development/lib.md
index 6b0372150..9c67a39dd 100644
--- a/support/doc/development/lib.md
+++ b/support/doc/development/lib.md
@@ -8,3 +8,16 @@
 $ cd client/src/standalone/player/
 $ npm run build
 ```
+
+## @peertube/peertube-types
+
+Typescript definition files generation is controlled by the various `tsconfig.types.json` files, see:
+```
+yarn tsc -b --verbose tsconfig.types.json
+```
+
+But the complete types package is generated via:
+```
+yarn generate-types-package
+```
+> See [scripts/generate-types-package.ts](scripts/generate-types-package.ts) for details.
diff --git a/support/doc/plugins/guide.md b/support/doc/plugins/guide.md
index 4a0d318a7..5c96d1b03 100644
--- a/support/doc/plugins/guide.md
+++ b/support/doc/plugins/guide.md
@@ -883,6 +883,39 @@ Now you can register hooks or settings, write CSS and add static directories to
 **Caution:** It's up to you to check the code you write will be compatible with the PeerTube NodeJS version,
 and will be supported by web browsers.
 If you want to write modern JavaScript, please use a transpiler like [Babel](https://babeljs.io/).
+If you want to use __Typescript__ see section below.
+
+### Typescript
+
+You can add __PeerTube__ types as dev dependencies:
+```
+npm install --dev @peertube/peertube-types
+```
+
+This package exposes *server* definition files by default:
+```ts
+import { RegisterServerOptions } from '@peertube/peertube-types'
+
+export async function register ({ registerHook }: RegisterServerOptions) {
+  registerHook({
+    target: 'action:application.listening',
+    handler: () => displayHelloWorld()
+  })
+}
+```
+
+But it also exposes client types and various models used in __PeerTube__:
+```ts
+import { RegisterClientOptions } from '@peertube/peertube-types/client'
+
+export function register ({ registerHook, peertubeHelpers }: RegisterClientOptions) {
+  registerHook({
+    target: 'action:application.init',
+    handler: () => onApplicationInit(peertubeHelpers)
+  })
+}
+```
+> Other types are accessible from the shared path `@peertube/peertube-types/shared`.
 
 ### Add translations