mirror of
https://github.com/flarum/framework.git
synced 2024-11-25 00:23:13 +08:00
3bdb0af993
* docs: remove baseUrl recommendation Fixes https://github.com/flarum/flarum-tsconfig/issues/4 * chore: implement change within framework monorepo
37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# Flarum Typescript Config
|
|
|
|
A standardised `tsconfig.json` for use in Flarum extensions.
|
|
|
|
## Usage
|
|
|
|
You'll need to configure a `tsconfig.json` file to ensure your IDE sets up Typescript support correctly.
|
|
|
|
You need to install this package as a dev dependency to your extension JS:
|
|
|
|
```properties
|
|
npm install --save-dev flarum-tsconfig
|
|
yarn add --dev flarum-tsconfig
|
|
```
|
|
|
|
A baseline `tsconfig.json` is provided below that you can modify as needed. This file needs to be copied into your extension's `js` folder for your IDE to apply the correct settings.
|
|
|
|
```jsonc
|
|
{
|
|
// Use Flarum's tsconfig as a starting point
|
|
"extends": "flarum-tsconfig",
|
|
// This will match all .ts, .tsx, .d.ts, .js, .jsx files in your `src` folder
|
|
// and also tells your Typescript server to read core's global typings for
|
|
// access to `dayjs` and `$` in the global namespace.
|
|
"include": ["src/**/*", "../vendor/flarum/core/js/dist-typings/@types/**/*"],
|
|
"compilerOptions": {
|
|
// This will output typings to `dist-typings`
|
|
"declarationDir": "./dist-typings",
|
|
"paths": {
|
|
"flarum/*": ["../vendor/flarum/core/js/dist-typings/*"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
You'll also need to ensure that you run `composer update` in your extension's root directory to ensure that a copy of Flarum core is downloaded to your `vendor` folder. Remember that `vendor` should **not** be committed to Git repositories.
|