From 90991da908b0725802db63d9fd8d5b4de1eb21a5 Mon Sep 17 00:00:00 2001
From: Colin McDonnell <colinmcd94@gmail.com>
Date: Mon, 31 Jul 2023 13:57:17 -0700
Subject: [PATCH] Update titles, add Workspaces guide

---
 bun.lockb                         | Bin 73269 -> 73269 bytes
 docs/guides/ecosystem/elysia.md   |   2 +-
 docs/guides/ecosystem/express.md  |   2 +-
 docs/guides/ecosystem/hono.md     |   2 +-
 docs/guides/ecosystem/mongoose.md |   2 +-
 docs/guides/ecosystem/stric.md    |   2 +-
 docs/guides/ecosystem/vite.md     |   2 +-
 docs/guides/install/workspaces.md |  68 ++++++++++++++++++++++++++++++
 docs/guides/util/base64.md        |  15 +++++++
 9 files changed, 89 insertions(+), 6 deletions(-)
 create mode 100644 docs/guides/install/workspaces.md
 create mode 100644 docs/guides/util/base64.md

diff --git a/bun.lockb b/bun.lockb
index ac7b5dac53b0627de1768be173a377000caae9a2..19dd97bbddcc5e6e0013c392df8a28ea45e98258 100755
GIT binary patch
delta 3859
zcmc&$!A`<J5FMl>DpffUP0wDuNc7;{yJwFY3$9^FL9zu6iOJwWKR^y91{0z`U_!X@
zA)fpKKf+nMiixIBw%d|4lvifn%$vtDqp>v_TW?jn*aLu7fNtiQZc21>_v!V{>|!B9
zpXKY7t{uXM1G{^JhfnRC<ycwy#G>mc2XJ~&+JiZ<CHmeirM4+!#p9)#Pf6y)C>FC#
z!CEcOM4n36pd>P3ld(#*1MoYc84Qyk3E@B`mznNDh>2G!jW0B=O_JSN4s0Vq=6k%+
z0=On@jh@MQ8p1FMk`N9w+Fb~7VDuXLyB)XgL7uF?uB5Idh+$g9iWev5O0whchNaO3
z$GUJY0Lr}ab8-ouAckoXD_)ep?L|A561tU3(V#PAum!N93>*PNo#2_VvcLx?IN191
zUQh*2F*^VMf(c?cvqH1Qpj;LHm&Poy;>C33cW{<L468u?i!6We7hP_1?;Jk10rJY#
z%#V(tPH+sdNQ*`Es$(Elyr?gsRxxt^!FrXB3b?5J(u6*%Uok<u|NeAOjEJF5a160(
j|BG0448+0Mebkpws~FUnoffg;J)XEfZuy7rk0<wETq58w

delta 3838
zcmc(h!A`<J5QazWL8U4u4PL!?k?6rk@Bw@PO`xu!q*QECLqalm@d4!E#RKsPObCew
zuHL<vcrreUGjyerP=sx_B>|E@o%weEozBi+XbgtNOV#YY?(7x5uRe?=2tWOv*=cv*
zO#_YNc8+y}zHjt%c2qimIkg-;cSmVWfR5$ZrJ7Gk=F~X0;R$RuZQ<pY0X8YgNEE`V
zwgCPnY-rOkT(v&P3<k0d+IANWW~ZO&v~Y`TFRlQrN&AKG*lrWxmb7)!_&hagm<D79
z1GVlh63q73{QXuL>kj0p^f#o{BQZq{vjR&l1~#O)V+OPRo?Z9K7YI<X-Erp%#1u7@
zEi-kn<f1B=Ei7A?o=Z)nw+*l=3wS{d;{?x)<pn+zgU0qm{{^|gNezPzHz}s5;lC@?
zyBLhNMlV=$adg3CW`B|1f4=!LbAiu)dSy<xpQ~E<m22BMhp%0LysT<f4TJkVxr7Vm
z!^C#7AXswg{Nq}v29{i&|5VQ|7FcporI5G?eNn#=9?kxT;hd<Th4Y_6@OZpZkEQuf
cJvf0_jBjBq7w~t+&&Y+7#O?2YKAztH0LEBX8vp<R

diff --git a/docs/guides/ecosystem/elysia.md b/docs/guides/ecosystem/elysia.md
index b0231ff95f..ae1a8e37b9 100644
--- a/docs/guides/ecosystem/elysia.md
+++ b/docs/guides/ecosystem/elysia.md
@@ -1,5 +1,5 @@
 ---
-name: Build an HTTP server using Elysia
+name: Build an HTTP server using Elysia and Bun
 ---
 
 [Elysia](https://elysiajs.com) is a Bun-first performance focused web framework that takes full advantage of Bun's HTTP, file system, and hot reloading APIs. Get started with `bun create`.
diff --git a/docs/guides/ecosystem/express.md b/docs/guides/ecosystem/express.md
index 55bd468bdb..211e117c46 100644
--- a/docs/guides/ecosystem/express.md
+++ b/docs/guides/ecosystem/express.md
@@ -1,5 +1,5 @@
 ---
-name: Build an HTTP server using Express
+name: Build an HTTP server using Express and Bun
 ---
 
 Express and other major Node.js HTTP libraries should work out of the box. Bun implements the [`node:http`](https://nodejs.org/api/http.html) and [`node:https`](https://nodejs.org/api/https.html) modules that these libraries rely on.
diff --git a/docs/guides/ecosystem/hono.md b/docs/guides/ecosystem/hono.md
index f0497da1f1..6d928a655d 100644
--- a/docs/guides/ecosystem/hono.md
+++ b/docs/guides/ecosystem/hono.md
@@ -1,5 +1,5 @@
 ---
-name: Build an HTTP server using Hono
+name: Build an HTTP server using Hono and Bun
 ---
 
 [Hono](https://github.com/honojs/hono) is a lightweight ultrafast web framework designed for the edge.
diff --git a/docs/guides/ecosystem/mongoose.md b/docs/guides/ecosystem/mongoose.md
index 406d2e77e2..bfcb957cc8 100644
--- a/docs/guides/ecosystem/mongoose.md
+++ b/docs/guides/ecosystem/mongoose.md
@@ -1,5 +1,5 @@
 ---
-name: Read and write data to MongoDB using Mongoose
+name: Read and write data to MongoDB using Mongoose and Bun
 ---
 
 MongoDB and Mongoose work out of the box with Bun. This guide assumes you've already installed MongoDB and are running it as background process/service on your development machine. Follow [this guide](https://www.mongodb.com/docs/manual/installation/) for details.
diff --git a/docs/guides/ecosystem/stric.md b/docs/guides/ecosystem/stric.md
index 309a857097..102bd339fb 100644
--- a/docs/guides/ecosystem/stric.md
+++ b/docs/guides/ecosystem/stric.md
@@ -1,5 +1,5 @@
 ---
-name: Build an HTTP server using StricJS
+name: Build an HTTP server using StricJS and Bun
 ---
 
 [StricJS](https://github.com/bunsvr) is a minimalist, fast web framework for Bun. Use `bun init` to create an empty project.
diff --git a/docs/guides/ecosystem/vite.md b/docs/guides/ecosystem/vite.md
index 62c116e021..857e11aae6 100644
--- a/docs/guides/ecosystem/vite.md
+++ b/docs/guides/ecosystem/vite.md
@@ -1,5 +1,5 @@
 ---
-name: Build a frontend using Vite
+name: Build a frontend using Vite and Bun
 ---
 
 {% callout %}
diff --git a/docs/guides/install/workspaces.md b/docs/guides/install/workspaces.md
new file mode 100644
index 0000000000..7c359b2855
--- /dev/null
+++ b/docs/guides/install/workspaces.md
@@ -0,0 +1,68 @@
+---
+name: Configuring a monorepo using workspaces
+---
+
+Bun's package manager supports npm `"workspaces"`. This allows you to split a codebase into multiple distinct "packages" that live in the same repository, can depend on each other, and (when possible) share a `node_modules` directory.
+
+---
+
+The root `package.json` should not contain any `"dependencies"`, `"devDependencies"`, etc. Each individual package should be self-contained and declare its own dependencies. Similarly, it's conventional to declare `"private": true` to avoid accidentally publishing the root package to `npm`.
+
+```json#package.json
+{
+  "name": "my-monorepo",
+  "private": true,
+  "workspaces": [
+    "packages/*"
+  ]
+}
+```
+
+---
+
+It's common to place all packages in a `packages` directory. The `"workspaces"` field in package.json supports glob patterns, so you can use `packages/*` to indicate that each subdirectory of `packages` should be considered separate _package_ (also known as a workspace).
+
+```txt
+.
+├── package.json
+├── node_modules
+└── packages
+    ├── stuff-a
+    │   └── package.json
+    └── stuff-b
+        └── package.json
+```
+
+---
+
+To add one workspace as a dependency of another, modify its `package.json`. Here were adding `stuff-a` as a dependency of `stuff-b`.
+
+```json#packages/stuff-b/package.json
+{
+  "name": "stuff-b",
+  "dependencies": {
++   "stuff-a": "*"
+  }
+}
+```
+
+---
+
+Once added, run `bun install` from the project root to install dependencies for all workspaces.
+
+```sh
+$ bun install
+```
+
+---
+
+To add npm dependencies to a particular workspace, just `cd` to the appropriate directory and run `bun add` commands as you would normally. Bun will detect that you are in a workspace and hoist the dependency as needed.
+
+```sh
+$ cd packages/stuff-a
+$ bun add zod
+```
+
+---
+
+See [Docs > Package manager](/docs/cli/install) for complete documentation of Bun's package manager.
diff --git a/docs/guides/util/base64.md b/docs/guides/util/base64.md
new file mode 100644
index 0000000000..06003f0622
--- /dev/null
+++ b/docs/guides/util/base64.md
@@ -0,0 +1,15 @@
+---
+name: Encode and decode base64 strings
+---
+
+Bun implements the Web-standard [`atob`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/atob) and [`btoa`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/btoa) functions for encoding and decoding base64 strings.
+
+```ts
+const data = "hello world";
+const encoded = btoa(data); // => "aGVsbG8gd29ybGQ="
+const decoded = atob(encoded); // => "hello world"
+```
+
+---
+
+See [Docs > API > Hashing](/docs/api/hashing#bun-password) for complete documentation.