Start here doc

astro/src/components/get-started/DockerInstallAndStart.astro

@@ -0,0 +1,78 @@
+
+---
+import DockerSpinupAccordion from 'src/components/get-started/DockerSpinupAccordion.astro';
+import Code from 'astro/components/Code.astro';
+import Aside from 'src/components/Aside.astro';
+import { RemoteValue } from '@fusionauth/astro-components';
+
+export interface Props {
+  /**
+   * Full URI to extract values from kickstart.json
+   * e.g. https://raw.githubusercontent.com/FusionAuth/fusionauth-quickstart-ruby-on-rails-web/main/kickstart/kickstart.json
+   */
+  kickstartUri: string;
+
+  /**
+   * Flag that indicates the codeRoot
+   */
+  codeRoot?: boolean;
+
+}
+
+const { kickstartUri, codeRoot } = Astro.props as Props;
+---
+<dd>
+<h2> Docker Requirements</h2>
+<Aside type="note">
+    You need to have Docker and Docker Compose installed.</Aside>
+
+
+<p>This document has been tested with Docker version `27.3.1`, but should work with other versions.</p>
+
+  <i>Testing the Docker Installation</i>
+
+ <Code lang="shell" code="docker -v" />
+
+ <i>Result Of Testing the Docker Installation</i>
+  <Code lang="shell" code="Docker version 27.3.1, build ce12230"/>
+
+<h2> Install and Start</h2>
+
+<h3>Clone the Code</h3>
+<p>First off, grab the code from the repository and change into that directory.</p>
+
+<Code lang="shell" code={`git clone https://github.com/FusionAuth/fusionauth-example-express-start-here/ && \\
+cd fusionauth-example-express-start-here`}/>
+
+<h3>Start FusionAuth via Docker</h3>
+
+<p>You'll find a Docker Compose file (<code>docker-compose.yml</code>) and an environment variables configuration file (<code>.env</code>) in the root directory of the repo.</p>
+
+<p>Stand up FusionAuth on your machine with the following command.</p>
+
+<Code lang="shell" code="docker compose up -d" />
+
+<p>You should see multiple containers start up; one for the database, one for FusionAuth and one for our mail server.</p>
+
+<p>Here you are using a bootstrapping feature of FusionAuth called <a href="/docs/get-started/download-and-install/development/kickstart">Kickstart</a>. When FusionAuth comes up for the first time, it will look at the <code>kickstart/kickstart.json</code> file and configure FusionAuth to the specified state. In this case, it is adding an application and a couple of users which you'll use later in the guide.</p>
+
+<Aside type="note">
+    <p>If you ever want to reset the FusionAuth application, you need to delete the volumes created by Docker Compose by executing <code style="white-space: nowrap">docker compose down -v</code>, then re-run <code>docker compose up -d</code>.</p>
+</Aside>
+
+<h3>Initial Settings</h3>
+<p>FusionAuth will be initially configured with these settings:</p>
+
+<ul>
+    <li>Your example username is <code><RemoteValue url={kickstartUri} selector="$.variables.userEmail" /></code> and the password is <code><RemoteValue url={kickstartUri} selector="$.variables.userPassword" /></code>.</li>
+    <li>Your admin username is <code><RemoteValue url={kickstartUri} selector="$.variables.adminEmail" /></code> and the password is <code><RemoteValue url={kickstartUri} selector="$.variables.adminPassword" /></code>.</li>
+    <li>The base URL of FusionAuth is <code>http://localhost:9011/</code>.</li>
+</ul>
+
+<h2>Summing Up</h2>
+
+<p>To verify that your system is set up, navigate to <a href="http://localhost:9011/admin">http://localhost:9011/admin</a> and log in using the admin credentials above. You will see the FusionAuth admin UI.</p>
+
+<p>Congratulations!  You've got your own FusionAuth instance running on your system using Docker.</p>
+
+</dd>

astro/src/components/get-started/DockerRequirements.astro

@@ -0,0 +1,23 @@
+---
+import Code from 'astro/components/Code.astro';
+import Aside from 'src/components/Aside.astro';
+---
+<dd>
+<h2> Docker Requirements</h2>
+<Aside type="note">
+    You need to have Docker and Docker Compose installed.</Aside>
+
+
+<p>This document has been tested with Docker version 20, but should work with other versions.</p>
+
+  <i>Testing the Docker Installation</i>
+
+ <Code lang="shell" code="docker -v" />
+
+
+ <i>Result Of Testing the Docker Installation</i>
+  <Code lang="shell" code="Docker version 20.10.17, build 100c701"/>
+
+  </dd>
+
+

astro/src/components/get-started/GitPodStart.astro

@@ -0,0 +1,51 @@
+---
+import Aside from 'src/components/Aside.astro';
+import Code from 'astro/components/Code.astro';
+import { RemoteValue } from '@fusionauth/astro-components';
+
+export interface Props {
+  /**
+   * Full URI to extract values from kickstart.json
+   * e.g. https://raw.githubusercontent.com/FusionAuth/fusionauth-quickstart-ruby-on-rails-web/main/kickstart/kickstart.json
+   */
+  kickstartUri: string;
+
+}
+
+const { kickstartUri, api = false } = Astro.props as Props;
+---
+<dd>
+
+<Aside type="note" title="GitPod Registration">  Note that the first time you start a GitPod workspace you will need to answer some demographic questions, but after that it will run without interruption.</Aside>
+
+<p>Click on the GitPod button below to start up your environment. It will take a few minutes to bring up the servers, so please be patient until the login page loads into the environment.</p>
+
+<a href="https://gitpod.io/#https://github.com/fusionauth/fusionauth-example-express-start-here" target="_blank" alt="Open in GitPod"><img src="https://gitpod.io/button/open-in-gitpod.svg" /></a>
+
+<p>The GitPod environment will spin up Docker containers with a FusionAuth instance, any dependencies, a terminal and an editor.</p>
+
+<p>Here you are using a bootstrapping feature of FusionAuth called <a href="/docs/get-started/download-and-install/development/kickstart">Kickstart</a>. When FusionAuth comes up for the first time, it will look at the <code>kickstart/kickstart.json</code> file and configure FusionAuth to your specified state.</p>
+
+<p>After the servers start up, you will be presented with a login screen in the GitPod 'Simple Browser', as well other parts of the GitPod environment.</p>
+
+<p>FusionAuth will be initially configured with these settings:</p>
+
+<ul>
+    <li>Your example username is <code><RemoteValue url={kickstartUri} selector="$.variables.userEmail" /></code> and the password is <code><RemoteValue url={kickstartUri} selector="$.variables.userPassword" /></code>.</li>
+    <li>Your admin username is <code><RemoteValue url={kickstartUri} selector="$.variables.adminEmail" /></code> and the password is <code><RemoteValue url={kickstartUri} selector="$.variables.adminPassword" /></code>.</li>
+    <li>The base URL of FusionAuth is based on your GitPod environment.</li>
+</ul>
+
+
+<h2> Summing Up</h2>
+
+<p>To verify that your system is set up, paste the below code into your GitPod terminal. When prompted, log in using the admin credentials (<code><RemoteValue url={kickstartUri} selector="$.variables.adminEmail" /></code> with the password <code><RemoteValue url={kickstartUri} selector="$.variables.userPassword" /></code>). You will see the FusionAuth admin UI.</p>
+
+<Aside type="tip">When you first copy and paste something in the GitPod environment, you may be presented with a popup asking for permission. Look out for that, and accept it to be able to paste commands into the environment.</Aside>
+
+<Code code="startadmin" />
+
+<p>Congratulations! You've got your own FusionAuth instance running in the GitPod cloud.</p>
+
+</dd>
+

astro/src/content/docs/get-started/index.mdx

@@ -6,6 +6,7 @@ section: get started
 ---
 import LoginBefore from 'src/diagrams/quickstarts/login-before.astro';
 import LoginAfter from 'src/diagrams/quickstarts/login-after.astro';
+import Aside from 'src/components/Aside.astro';
 
 ## Introduction
 
@@ -14,6 +15,8 @@ login, registration, localized email, multi-factor authentication, reporting and
 
 If you're looking for employee login or a replacement for Active Directory - you may be in the wrong place. While FusionAuth can be used for nearly any application, we do not offer native desktop integration and replacing Active Directory is not on our roadmap. However, if you're looking for a solution to manage end users that can perform at scale, then keep reading.
 
+<Aside title="Jump In!">For a quick interactive introduction to FusionAuth, check out our [Start Here](/docs/get-started/start-here) tutorial.</Aside>
+
 Here's a typical application login flow before FusionAuth.
 
 <LoginBefore alt="Login before FusionAuth" />

astro/src/content/docs/get-started/start-here/_admin-access-instructions.mdx

@@ -0,0 +1,13 @@
+---
+---
+import Code from 'astro/components/Code.astro';
+
+<details>
+<summary>Docker</summary>
+Point your browser to <Code code="http://localhost:9011/admin" />
+</details>
+
+<details>
+<summary>GitPod</summary>
+<Code code="startadmin" />
+</details>

astro/src/content/docs/get-started/start-here/_app-access-instructions.mdx

@@ -0,0 +1,13 @@
+---
+---
+import Code from 'astro/components/Code.astro';
+
+<details>
+<summary>Docker</summary>
+Point your browser to <Code code="http://localhost:8080/" />
+</details>
+
+<details>
+<summary>GitPod</summary>
+<Code code="starthere" />
+</details>

astro/src/content/docs/get-started/start-here/_mail-access-instructions.mdx

@@ -0,0 +1,13 @@
+---
+---
+import Code from 'astro/components/Code.astro';
+
+<details>
+<summary>Docker</summary>
+Point your browser to <Code code="http://localhost:1080/" />
+</details>
+
+<details>
+<summary>GitPod</summary>
+<Code code="startemail" />
+</details>