From da031b57ebeef74fad2ca5156975b7d8571c07bf Mon Sep 17 00:00:00 2001
From: Seth Silesky <5115498+silesky@users.noreply.github.com>
Date: Sun, 27 Nov 2022 17:49:42 -0600
Subject: [PATCH] update monorepo README with development instructions and
 badges

---
 DEVELOPMENT.md |  8 ++++++++
 README.md      | 28 ++++++++++++++++++++++------
 2 files changed, 30 insertions(+), 6 deletions(-)
 create mode 100644 DEVELOPMENT.md

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
new file mode 100644
index 000000000..b1606327b
--- /dev/null
+++ b/DEVELOPMENT.md
@@ -0,0 +1,8 @@
+## Development
+
+```sh
+ git clone git@github.com:segmentio/analytics-next.git && cd analytics-next
+ nvm use  # install version of node defined in .nvmrc.
+ yarn && yarn build
+ yarn lint && yarn test
+```
diff --git a/README.md b/README.md
index 16b3316e4..e28f1eae4 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,32 @@
-# Segment Analytics JS
+<div style="display:flex;margin-bottom:5px">
+  <span style="margin: 0 5px 5px">
+    <a href="https://buildkite.com/segment/analytics-next">
+    <img src="https://badge.buildkite.com/87e30d62ada044b6fe404b17cd16aa6e3b52d89f40c9f44675.svg?branch=master">
+  </a>
+
+  </span>
+  <span style="margin:0 5px 5px">
+     <a href="http://www.typescriptlang.org/">
+    <img src="https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg">
+  </span>
+</div>
+
 <p align="center">
   <a href="https://segment.com">
     <img src="https://brand.segment.com/site-assets/7b19c1a2/images/brand-guidelines/content/twilio/twilio-segment-logo-2x.png" width="300">
   </a>
   <br />
-  <caption>Welcome to the monorepo for Segment's Javascript SDKs!</caption>
+  <caption>Welcome to the monorepo for Segment's latest Javascript / Typescript SDKs</caption>
 </p>
 
-## NPM Packages
-* [@segment/analytics-next](packages/browser#readme): Analytics SDK for web browsers
-* [@segment/analytics-node](packages/node#readme) (⚠️ Beta): Segment Analytics SDK for Node.js
+# analytics.js (analytics-next)
 
+## Packages
+
+- [@segment/analytics-next](packages/browser#readme): Analytics.js SDK for **web browsers**
+- [@segment/analytics-node](packages/node#readme) (⚠️ Beta): Analytics.js SDK for **Node.js**
 
 ## Contributing
-Check out our contribution guidelines: [CONTRIBUTING.md](CONTRIBUTING.md)
+
+- Contribution guidelines: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Development instructions: [DEVELOPMENT.md](DEVELOPMENT.md)