From 33c88c9535ef011edb7039f391e0e1ca498438f0 Mon Sep 17 00:00:00 2001
From: David Mark Clements <david.mark.clements@gmail.com>
Date: Mon, 27 Nov 2023 14:53:46 +0100
Subject: [PATCH] getting started

---
 README.md          | 18 +++++++++++++++++-
 getting-started.md | 47 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 64 insertions(+), 1 deletion(-)
 create mode 100644 getting-started.md

diff --git a/README.md b/README.md
index 2a5fa1d..9ddaf71 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,17 @@
-# pears_com-docs
\ No newline at end of file
+# Pear by Holepunch
+
+> Pear loads applications remotely from peers and allows anyone to create and share applications with peers.
+
+Pear by Holepunch is a combined Peer-to-Peer (P2P) Runtime, Development & Deployment tool.
+
+Pear makes it possible to build, share and extend P2P applications using common Web and Mobile technology.
+
+Herein is everything needed to create unstoppable, zero-infrastructure P2P applications for Desktop, Terminal & Mobile.
+
+Welcome to the Internet of Peers  
+&nbsp; _– Holepunch, the P2P Company_
+
+## Table of Contents
+
+* [Getting Started](./getting-started.md)
+* [Making a Pear App](./making-a-pear-app.md)
\ No newline at end of file
diff --git a/getting-started.md b/getting-started.md
new file mode 100644
index 0000000..bb5b22c
--- /dev/null
+++ b/getting-started.md
@@ -0,0 +1,47 @@
+# Getting Started with Pear
+
+## Requirements
+
+Pear runs on Windows, Mac and Linux.
+
+The `pear` CLI can be installed from [npm](https://www.npmjs.com/), which comes with [`node`](https://nodejs.org/en/about). 
+
+The `npm` package manager can also be used to install application dependencies later on.
+
+On MacOS and Linux, we recommend installing `node` using [`nvm`](https://github.com/nvm-sh/nvm#installing-and-updating)
+
+On Windows we recommend installing `node` with [`nvs`](https://github.com/jasongin/nvs#setup).
+
+> Info: The Pear Runtime does not rely on `node`, `node` is only needed to install and run the `npm` package manager.
+
+## Setup
+
+To install Pear run the following command:
+
+```sh
+npm i -g pear
+```
+
+To complete the setup, run the `pear` command.
+
+```
+pear
+```
+
+If a Pear application, such as [Keet](https://keet.io) is already installed on a machine then the Pear
+platform is already available. In this case, running `pear` should show the pear help output.
+ 
+If not, the first run of `pear` will fetch the platform from peers, after which running `pear` again should output help information.
+
+To check that Pear is fully working, try the following command:
+
+```
+pear launch keet
+```
+
+Pear loads applications from peers, so this command should launch [Keet](https://keet.io) whether or not it was downloaded and installed beforehand.
+
+
+## Next
+
+* [Making a Pear App](./making-a-pear-app.md)
\ No newline at end of file