Skip to content

Commit 516b95d

Browse files
committed
Add pinned-dependencies / external-stdlib config in configuration page
1 parent 0163f10 commit 516b95d

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

pages/docs/manual/latest/build-configuration.mdx

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,18 @@ List of ReScript dependencies. Just like `package.json`'s dependencies, they'll
8080

8181
Note that only sources marked with `"type":"dev"` will be able to resolve modules from `bs-dev-dependencies`.
8282

83+
## pinned-dependencies
84+
85+
**Since 8.4**: List of pinned dependencies. A pinned dependency will always be rebuilt whenever you build a toplevel package (e.g. your main app) with `bsb -make-world`.
86+
87+
This is useful for working on multiple independent ReScript packages simultaneously. More usage details can be found in our [monorepo setup](./build-monorepos) page.
88+
89+
## external-stdlib
90+
91+
**Since 9.0**: This setting allows depending on an externally built stdlib package (instead of a locally built stdlib runtime). Useful for shipping packages that are only consumed in JS or TS without any dependencies to the ReScript development toolchain.
92+
93+
More details can be found on our [external stdlib](./build-external-stdlib) page.
94+
8395
## reason, refmt (old)
8496

8597
`reason` config is enabled by default. To turn on JSX for [ReasonReact](https://reasonml.github.io/reason-react/), specify:
@@ -136,7 +148,7 @@ This configuration only applies to you, when you develop the project. When the p
136148

137149
## suffix
138150

139-
Either `".js"` or `".bs.js"`. Strongly prefer the latter.
151+
Either `".js"`, `".mjs"`, `".cjs"` or `".bs.js"`. Currently prefer `bs.js` for now.
140152

141153
### Design Decisions
142154

@@ -145,7 +157,7 @@ Generating JS files with the `.bs.js` suffix means that, on the JS side, you can
145157
- It's immediately clear that we're dealing with a generated JS file here.
146158
- It avoids clashes with a potential `theFile.js` file in the same folder.
147159
- It avoids the need of using a build system loader for ReScript files. This + in-source build means integrating a ReScript project into your pure JS codebase **basically doesn't touch anything in your build pipeline at all**.
148-
- The `.bs.js` suffix [lets bsb track JS artifacts much better](build-overview.md#tips-tricks).
160+
- [genType](/docs/gentype/latest/introduction) requires `bs.js` for compiled JS artifacts. If you are using `genType`, you need to use `bs.js` for now.
149161

150162
## warnings
151163

0 commit comments

Comments
 (0)