move tutorial to its own file #53

tutorial.md

@@ -0,0 +1,90 @@
+# _Tutorial_
+
+This tutorial takes you through _building_ a sleep tracking App from scratch
+so that you can understand how it works.
+If you get stuck, _please_
+[**ask questions**!](https://github.com/dwyl/sleep/issues)
+
+
+## Implementation Note
+
+We built this MVP App using using 
+[**`Elixir`**](https://github.com/dwyl/learn-elixir) 
+and 
+[**`Phoenix`**](https://github.com/dwyl/learn-phoenix-framework) 
+because it's one of the simplest ways 
+to build web applications
+from first principals.
+Our objective is to get to a _useable_ app
+as **_fast_ as possible** 
+so we can start inputting/saving data.
+You will see below, 
+that we can get up-and-running
+with a **basic interface**,
+**saving data** to the database,
+**authentication**
+and ***deployment***
+in **_less_ than 20 minutes**. <!-- <sup>1</sup> -->
+Anyone who knows basic programming 
+(e.g. `Python`, `JavaScript`, etc.)
+should be able to follow along.
+
+
+<!--
+<sup>1</sup> 
+Other approaches to web app development 
+might get you different results ... 
+https://twitter.com/iamdevloper/status/787969734918668289
+-->
+
+## Create New Phoenix App
+
+```sh
+mix phx.new app --no-mailer --no-dashboard
+```
+
+This creates a new Phoenix Web App named **`app`**
+without the mailer (email) or live dashboard
+but with a database and `LiveView` support.
+
+
+When you see the prompt asking you 
+to fetch and install the dependencies:
+
+```
+Fetch and install dependencies? [Yn]
+```
+
+Type `y` followed by the `Enter` key:
+
+You should then see:
+
+```
+* running mix deps.get
+* running mix deps.compile
+```
+
+To start the Phoenix server:
+
+* Install dependencies with `mix deps.get`
+* Create and migrate your database with `mix ecto.setup`
+* Start Phoenix endpoint with `mix phx.server`
+
+You should see the following output in your terminal:
+
+```
+[info] Running AppWeb.Endpoint with cowboy 2.9.0 at 127.0.0.1:4000 (http)
+[debug] Downloading esbuild from https://registry.npmjs.org/esbuild-darwin-64/-/esbuild-darwin-64-0.13.5.tgz
+[info] Access AppWeb.Endpoint at http://localhost:4000
+[watch] build finished, watching for changes...
+```
+
+When you open http://localhost:4000 in your web browser,
+you should see see something similar to the following:
+
+![phoenix-framerwork-welcome-page](https://user-images.githubusercontent.com/194400/145309471-306fdd5e-324f-4c4a-bd9f-6fddbec7f512.png)
+
+
+<!-- uncomment when ready for review
+[![HitCount](http://hits.dwyl.com/dwyl/sleep_tutorial.svg?style=flat-square)](http://hits.dwyl.com/dwyl/sleep)
+-->