From 7d452383954491ebbb5f54a078d43755af384bf1 Mon Sep 17 00:00:00 2001
From: Shahed Nasser <shahednasser@gmail.com>
Date: Tue, 12 Apr 2022 17:39:04 +0300
Subject: [PATCH] added admin quickstart (#1323)

---
 docs/content/admin/quickstart.md | 141 +++++++++++++++++++++++++++++++
 www/docs/sidebars.js             |   4 +
 2 files changed, 145 insertions(+)
 create mode 100644 docs/content/admin/quickstart.md

diff --git a/docs/content/admin/quickstart.md b/docs/content/admin/quickstart.md
new file mode 100644
index 0000000000..4fb4929845
--- /dev/null
+++ b/docs/content/admin/quickstart.md
@@ -0,0 +1,141 @@
+---
+
+title: Medusa Admin Quickstart
+
+---
+
+# Admin Quickstart
+
+This document will guide you through setting up the Medusa admin in minutes, as well as some of its features.
+
+## Prerequisites
+
+The Medusa admin is connected to the Medusa server. So, make sure to install the Medusa server first before proceeding with the admin. You can check out the [quickstart guide to install the Medusa server](../quickstart/quick-start).
+
+:::tip
+
+If you’re not very familiar with Medusa’s architecture, you can learn more about it in the [Architecture Overview](../introduction#architecture-overview).
+
+:::
+
+## Install the Admin
+
+Start by cloning the [Admin GitHub repository](https://github.com/medusajs/admin):
+
+```bash
+git clone https://github.com/medusajs/admin medusa-admin
+```
+
+Then, change to the cloned directory and install the dependencies:
+
+```bash
+cd medusa-admin
+npm install
+```
+
+## Test it Out
+
+Before running your Medusa admin, make sure that your Medusa server is running.
+
+:::tip
+
+To run your Medusa server, go to the directory holding the server and run `npm start`.
+
+:::
+
+Then, in the directory holding your Medusa admin, run the following to start the development server:
+
+```bash
+npm start
+```
+
+By default, the admin runs on port 7000. So, in your browser, go to `localhost:7000` to view your admin.
+
+![Admin Log In](https://i.imgur.com/XYqMCo9.png)
+
+Use your Medusa admin’s user credentials to log in.
+
+:::tip
+
+If you installed the demo data when you installed the Medusa server by using the `--seed` option or running `npm run seed`, you can use the email `admin@medusa-test.com` and password `supersecret` to log in.
+
+:::
+
+## Create a New Admin User
+
+To create a new admin user from the command line, run the following command in the directory holding your Medusa server:
+
+```bash
+medusa user -e some@email.com -p some-password
+```
+
+This will create a new user that you can use to log into your admin panel.
+
+## Changing the Default Port
+
+The default port is set in `package.json` in the `develop` script:
+
+```json
+"develop": "gatsby develop -p 7000",
+```
+
+If you wish to change the port you can simply change the `7000` to your desired port.
+
+However, if you change your Medusa admin port, you need to change it in your Medusa server. The Medusa server has the Medusa admin and store URLs set in the configurations to avoid CORS issues.
+
+To change the URL of the Medusa admin in the server, add a new environment variable `ADMIN_CORS` or modify it if you already have it to your Admin URL:
+
+```bash
+ADMIN_CORS=<YOUR_ADMIN_URL>
+```
+
+Make sure to replace `<YOUR_ADMIN_URL>` with your URL.
+
+## Admin Features Overview
+
+### Order Management
+
+In the Medusa admin, you can view all orders in your store and their details. You can fulfill orders, capture payments, and track order history. You can also create and manage return requests, swaps, and claims.
+
+![Order Management](https://i.imgur.com/aE0wOHA.png)
+
+### Product Management
+
+In the Medusa admin, you can manage your store’s products. You can create products, add their description and images, create variants with multiple options, set different prices for different currencies, and manage inventory.
+
+:::note
+
+To upload images and save products, you need to integrate a file storage plugin. You can use [DigitalOcean Spaces](../add-plugins/spaces), [S3](../add-plugins/s3), or [MinIO](../add-plugins/minio).
+
+:::
+
+![Product Management](https://i.imgur.com/hgqqv4p.png)
+
+### Customer Management
+
+In the Medusa admin, you can manage your store’s customers. You can manage their information and get a close-up on their orders.
+
+![Customer Management](https://i.imgur.com/bPAImGY.png)
+
+### Discounts Management
+
+In the Medusa admin, you can manage your store’s discounts. You can create and manage discounts created for all products or specific products. Discounts can also be of a fixed amount or free shipping. You can also customize the discount code, its expiry date, its description, and more.
+
+![Discounts Management](https://i.imgur.com/CUUcLba.png)
+
+### Gift Cards Management
+
+In the Medusa admin, you can manage your store’s gift card products. You can create a gift card product with images and descriptions. You can specify unlimited denominations as well.
+
+![Gift Cards Management](https://i.imgur.com/243IhXA.png)
+
+### Settings Management
+
+In the Medusa admin, you can manage your store’s overall settings. These include your store’s regions, fulfillment providers, payment providers, your store’s users, and more.
+
+![Settings Management](https://i.imgur.com/MJc92CU.png)
+
+## What’s Next 🚀
+
+- Install the [Next.js](../starters/nextjs-medusa-starter.md) or [Gatsby](../starters/gatsby-medusa-starter.md) storefront starters.
+- [Learn how you can use `create-medusa-app` to install all of Medusa’s 3 components.](../how-to/create-medusa-app.md)
diff --git a/www/docs/sidebars.js b/www/docs/sidebars.js
index b2e7a938ac..509b7d2b40 100644
--- a/www/docs/sidebars.js
+++ b/www/docs/sidebars.js
@@ -63,6 +63,10 @@ module.exports = {
             },
           ],
         },
+        {
+          type: "doc",
+          id: "admin/quickstart",
+        },
         {
           type: "doc",
           id: "how-to/create-medusa-app",