Skip to content

Commit 29e7f79

Browse files
authored
Update README.md
1 parent 4344f7e commit 29e7f79

File tree

1 file changed

+17
-2
lines changed

1 file changed

+17
-2
lines changed

Diff for: README.md

+17-2
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,27 @@ There are 3 ways to deploy functions to Netlify:
1313
2. each function as a zip of a folder of files
1414
3. as of [CLI v2.7](https://www.netlify.com/docs/cli/#unbundled-javascript-function-deploys), a non-bundled, non-zipped, folder of files.
1515

16-
`Netlify-Lambda` uses webpack to bundle up your functions and their dependencies for you, suiting the first approach. However, if you have native node modules (or other dependencies that don't expect to be bundled like [the Firebase SDK](https://github.com/netlify/netlify-lambda/issues/112)) then you may want to try the other approaches.
16+
`Netlify-Lambda` uses webpack to bundle up your functions and their dependencies for you, suiting the first approach. However, if you have native node modules (or other dependencies that don't expect to be bundled like [the Firebase SDK](https://github.com/netlify/netlify-lambda/issues/112)) then you may want to try the other approaches. In particular, try [`Netlify Dev`](https://github.com/netlify/netlify-dev-plugin#what-is-netlify-dev).
17+
18+
If this sounds confusing, support is available through [our regular channels](https://www.netlify.com/support/).
19+
</details>
20+
21+
22+
<details>
23+
<summary><b>[`Netlify Dev`](https://github.com/netlify/netlify-dev-plugin#what-is-netlify-dev) vs. Netlify-Lambda</b></summary>
24+
25+
Some headline notes:
26+
27+
- **`netlify-lambda` is not deprecated and will continue to be supported.**
28+
- Part of Netlify Dev serves unbundled function folders through [zip-it-and-ship-it](https://github.com/netlify/zip-it-and-ship-it) with no build step. This is likely to be attractive to many users who previously needed `netlify-lambda` for function folders.
29+
- However, if you want to use a build step for your functions (e.g. for webpack import/export, babel or typescript), you can use `netlify-lambda`, `tsc` or your own build tool to do this, just point Netlify Dev at your build output with the `functions` field in `netlify.toml`.
30+
- Finally, We also want **existing `netlify-lambda` users to be able to use Netlify Dev with no change to their workflow**. This is done through the [Netlify Dev Function Builder](https://github.com/netlify/netlify-dev-plugin#function-builders-function-builder-detection-and-relationship-with-netlify-lambda) abstraction. It is, however, a very new feature with only simple detection logic for now, that we aim to improve over time. If it doesn't work well for you, you can simply not use Netlify Dev for now while we work out all your bug reports.
1731

18-
If this sounds confusing, support is available through [our regular channels](https://www.netlify.com/support/). An update on how this will be supported locally will come [in April](https://jamstackconf.com/nyc/). Importantly, **There will be no change to the workflow of existing `netlify-lambda` users.**
1932

2033
</details>
2134

35+
36+
2237
## Installation
2338

2439
**We recommend installing locally** rather than globally:

0 commit comments

Comments
 (0)