Docusaurus supports writing and using TypeScript theme components. To start using TypeScript, add
@docusaurus/module-type-aliases to your project:
tsconfig.json to your project root with following content:
Docusaurus doesn't use this
tsconfig.json to compile your TypeScript. It is added just for a nicer Editor experience, although you can choose to run
tsc --noEmit to type check your code for yourself.
types.d.ts in your
src folder with the following content:
This file makes TypeScript recognize various Docusaurus specific webpack aliases like
Now you can start writing TypeScript theme components.
Swizzling TypeScript theme components
For themes that supports TypeScript theme components, you can add the
--typescript flag to the end of swizzling command to get TypeScript source code. For example, the following command will generate
At this moment, the only official Docusaurus theme that supports TypeScript theme components is
@docusaurus/theme-classic. If you are a Docusaurus theme package author who wants to add TypeScript support, see the Lifecycle APIs docs.