docs: create docs workspace (#5174)

* docs: migrate ui docs to docs universe * created yarn workspace * added eslint and tsconfig configurations * fix eslint configurations * fixed eslint configurations * shared tailwind configurations * added shared ui package * added more shared components * migrating more components * made details components shared * move InlineCode component * moved InputText * moved Loading component * Moved Modal component * moved Select components * Moved Tooltip component * moved Search components * moved ColorMode provider * Moved Notification components and providers * used icons package * use UI colors in api-reference * moved Navbar component * used Navbar and Search in UI docs * added Feedback to UI docs * general enhancements * fix color mode * added copy colors file from ui-preset * added features and enhancements to UI docs * move Sidebar component and provider * general fixes and preparations for deployment * update docusaurus version * adjusted versions * fix output directory * remove rootDirectory property * fix yarn.lock * moved code component * added vale for all docs MD and MDX * fix tests * fix vale error * fix deployment errors * change ignore commands * add output directory * fix docs test * general fixes * content fixes * fix announcement script * added changeset * fix vale checks * added nofilter option * fix vale error
2023-09-21 20:57:15 +03:00
parent 19c5d5ba36
commit fa7c94b4cc
3209 changed files with 32188 additions and 31018 deletions
@@ -0,0 +1,39 @@
+When using the `create-medusa-app` npx command, you might run into an NPM `EAGAIN` error. This error can randomly occur due to conflicting processes.
+
+The easiest solution is to start the command over. Alternatively, if your setup crossed the "create database" point, you can manually perform the following steps in the directory of your created project. You can skip any steps that you're sure have been performed by `create-medusa-app`:
+
+1\. Install dependencies:
+
+```bash npm2yarn
+npm install
+```
+
+2\. Build project:
+
+```bash npm2yarn
+npm run build
+```
+
+3\. Run migrations:
+
+```bash
+npx medusa migrations run
+```
+
+4\. Create an admin user:
+
+```bash
+npx medusa user -e user@test.com -p supersecret
+```
+
+5\. Optionally seed the database:
+
+```bash
+npx medusa seed -f ./data/seed.json
+```
+
+6\. Start project:
+
+```bash
+npx medusa develop
+```
@@ -0,0 +1,5 @@
+If you use the `--no-browser` option with the `create-medusa-app` command, you'll find a URL outputted at the end of the command execution. This is the URL that you can use to set a password for your admin user.
+
+However, if you copy the URL, then try later to access that URL, you may receive an "Invalid Token" error. This is because when you copy the URL, a lot of extra space may be added into the token. So, you must clear out the spaces within the token and the `||` characters, then try again.
+
+Alternatively, you can create a new user with the [medusa user](../../cli/reference.mdx#user) command.
@@ -0,0 +1,31 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+As a last resort to resolve your issue, please try to clear your `npx` cache, as it could hold a cached version of `create-medusa-app` with errors.
+
+<Tabs groupId="operating-systems" queryString="os">
+<TabItem value="unix" label="MacOS and Linux" default>
+
+Run the following command:
+
+```bash
+rm -rf "$(npm config get cache)/_npx"
+```
+
+Try running the `create-medusa-app` command again.
+
+</TabItem>
+<TabItem value="windows" label="Windows">
+
+First, find the cache directory with the following command:
+
+```bash
+npm config get cache
+```
+
+The npx cache should be in the directory `<NPM_CACHE>/_npx`, where `<NPM_CACHE>` is the cache directory returned by the previous command. Delete that directory and try running the `create-medusa-app` command again.
+
+</TabItem>
+</Tabs>
+
+If your issue persists, please try to search through [our GitHub issues](https://github.com/medusajs/medusa/issues) to see if there's a solution for your issue. If not, please [create an issue on GitHub](https://github.com/medusajs/medusa/issues/new?assignees=olivermrbl&labels=status:+needs+triaging,+type:+bug&template=bug_report.md&title=) and our team will help you resolve it soon.
@@ -0,0 +1,8 @@
+This error typically occurs when you set up a Medusa project with `create-medusa-app` and try to run the Medusa backend.
+
+To resolve this issue, make sure you change into the `backend` directory of the Medusa project you created before trying to start the Medusa backend:
+
+```bash npm2yarn
+cd backend
+npx medusa develop
+```