ZephyrCloudIO · Nsttt · Dec 11, 2025 · Dec 11, 2025 · Dec 11, 2025 · Dec 15, 2025
diff --git a/docs/errors/ze00000.mdx b/docs/errors/ze00000.mdx
@@ -0,0 +1,30 @@
+---
+title: 'ZE00000: Unknown error'
+description: 'ZE00000: Unknown error occurred during Zephyr operation'
+head:
+  - - meta
+    - property: og:description
+      content: 'ZE00000: Unknown error occurred during Zephyr operation'
+---
+
+import { getErrorMessage } from '../../lib/error-helpers.ts';
+import { ErrorInfo } from '../../components/errors/info.tsx';
+
+# {getErrorMessage('ZE00000')}
+
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
+<ErrorInfo code="ZE00000" terminal />
+
+This is a catch-all error that occurs when an unexpected or unclassified error happens during Zephyr operations. The underlying cause may vary.
+
+## Debugging the error
+
+If you encounter this error, please:
+
+1. Check the complete error details in the temporary JSON file mentioned in the error output
+2. Review your network connection and ensure you can reach Zephyr's servers
+3. Verify your project configuration is correct
+
diff --git a/docs/errors/ze10010.mdx b/docs/errors/ze10010.mdx
@@ -14,6 +14,10 @@ import { Steps } from '@rspress/core/theme';
 
 # {getErrorMessage('ZE10010')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10010" terminal />
 
 This method is implemented across all bundlers' plugins (see our [supported bundlers and their relevant packages](/getting-started/quick-start)).

diff --git a/docs/errors/ze10011.mdx b/docs/errors/ze10011.mdx
@@ -11,10 +11,12 @@ import { getErrorMessage } from '../../lib/error-helpers.ts';
 import { ErrorInfo } from '../../components/errors/info.tsx';
 import { ErrorLink } from '../../components/errors/link.tsx';
 
-# ZE10011 package.json not found
-
 # {getErrorMessage('ZE10011')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10011" terminal />
 
 After we recursively loop for the current working directory where the bundler's config lives and locate the `package.json` file, we then perform a parsing function to make sure your `package.json` is a valid [JSON](https://www.json.org/json-en.html) format.

diff --git a/docs/errors/ze10012.mdx b/docs/errors/ze10012.mdx
@@ -12,6 +12,10 @@ import { ErrorInfo } from '../../components/errors/info.tsx';
 
 # {getErrorMessage('ZE10012')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10012" terminal />
 
 ::: warning

diff --git a/docs/errors/ze10013.mdx b/docs/errors/ze10013.mdx
@@ -12,6 +12,10 @@ import { ErrorInfo } from '../../components/errors/info.tsx';
 
 # {getErrorMessage('ZE10013')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10013" terminal related="ZE10017,ZE10011" />
 
 When you are running a build through Zephyr, we will verify your `package.json`'s fields to check whether you have the **name** and **version** fields. Later one we use those values to compose `application_uid`. Behind the scene we will be using your `applicaiton_uid` to deploy your application with related information as well as generating build id.

diff --git a/docs/errors/ze10014.mdx b/docs/errors/ze10014.mdx
@@ -12,6 +12,10 @@ import { ErrorInfo } from '../../components/errors/info.tsx';
 
 # {getErrorMessage('ZE10014')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10014" terminal />
 
 If you have successfully deployed one application, you will see your deployed url is a composition of your github's organization name, repository name as well as your `package.json`'s name (yep, we might we done some data sanitization for it). This information is also how we store your information locally (There is a `~/.zephyr` in your root dir) to enable lightning fast deployment. We extract your organization's name and repository name

diff --git a/docs/errors/ze10015.mdx b/docs/errors/ze10015.mdx
@@ -12,6 +12,10 @@ import { ErrorInfo } from '../../components/errors/info.tsx';
 
 # {getErrorMessage('ZE10015')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10015" terminal />
 
 We store your user information at your local machine so when we are starting the build process we won't waste time on data transfer between your machine to data center. Each of your project's build, information, authentication to deployment platform (encrypted) are in a local folder called `~/.zephyr`.

diff --git a/docs/errors/ze10016.mdx b/docs/errors/ze10016.mdx
@@ -13,6 +13,10 @@ import { ErrorLink } from '../../components/errors/link.tsx';
 
 # {getErrorMessage('ZE10016')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10016" terminal related="ZE10014,ZE10015,ZE10017" />
 
 There could be several reason why this error shows up - it could be because remote origin wasn't configured for the project directory; it could be because you haven't set a username for git; or it could be because you don't have an email set to your git config.

diff --git a/docs/errors/ze10017.mdx b/docs/errors/ze10017.mdx
@@ -14,6 +14,10 @@ import { Steps } from '@rspress/core/theme';
 
 # {getErrorMessage('ZE10017')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10017" terminal related="ZE20012" />
 
 After generating your `application_uid` based on your git config and `package.json`, we save them to your local disk in a folder named `~/.zephyr` and we utilize the information there to help you deploy your applications. Each one of your application has their own unique `application_uid`.

diff --git a/docs/errors/ze10018.mdx b/docs/errors/ze10018.mdx
@@ -13,6 +13,10 @@ import { Steps } from '@rspress/core/theme';
 
 # {getErrorMessage('ZE10018')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10018" terminal />
 
 This error might happen for several reasons when you are running a build.

diff --git a/docs/errors/ze10019.mdx b/docs/errors/ze10019.mdx
@@ -14,12 +14,14 @@ import { Steps } from '@rspress/core/theme';
 
 # {getErrorMessage('ZE10019')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10019" terminal />
 
 ::: info
-
-This is one of the most common error during build.
-
+This is one of the most common errors during build.
 :::
 
 Once we find your `application_uid` (composed by your github organization's name, project name and the `name` field in package.json, refer to <ErrorLink code="ZE10017" />), we will be collecting data from your local cache, verifying your JWT token and checking your write access to the related project. If we fail to find all the necessary configuration, we won't be able to obtain appropriate build id for you to continue with the deployment.

diff --git a/docs/errors/ze10020.mdx b/docs/errors/ze10020.mdx
@@ -14,6 +14,10 @@ import { ErrorLink } from '../../components/errors/link.tsx';
 
 # {getErrorMessage('ZE10020')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10020" terminal plugins="Rollup" />
 
 On your build start, there are a list of actions we run through. If any of these actions failed, Zephyr agent will fail to initialize in the Rollup plugin.

diff --git a/docs/errors/ze10021.mdx b/docs/errors/ze10021.mdx
@@ -13,6 +13,10 @@ import { Steps } from '@rspress/core/theme';
 
 # {getErrorMessage('ZE10021')}
 
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
 <ErrorInfo code="ZE10021" terminal />
 
 This error happens when your terminal session doesn't have the necessary permissions to create the `dist` folder. This can happen if you're running the command as a different user or if the permissions on the folder are incorrect.

diff --git a/docs/errors/ze10022.mdx b/docs/errors/ze10022.mdx
@@ -0,0 +1,45 @@
+---
+title: 'ZE10022: Auth forbidden error'
+description: 'ZE10022: Authentication forbidden - access denied to requested resource'
+head:
+  - - meta
+    - property: og:description
+      content: 'ZE10022: Authentication forbidden - access denied to requested resource'
+---
+
+import { getErrorMessage } from '../../lib/error-helpers.ts';
+import { ErrorInfo } from '../../components/errors/info.tsx';
+import { Steps } from '@rspress/core/theme';
+
+# {getErrorMessage('ZE10022')}
+
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
+<ErrorInfo code="ZE10022" terminal />
+
+This error occurs when your authentication credentials are valid but you don't have permission to access the requested resource or perform the requested action.
+
+## Debugging the error
+
+<Steps>
+
+### Verify your account permissions
+
+Ensure your account has the necessary permissions for the project or organization you're trying to access.
+
+### Check organization membership
+
+If working with an organization project, confirm you're a member of that organization with appropriate access rights.
+
+### Re-authenticate
+
+Try clearing your local Zephyr credentials and logging in again from the [dashboard](https://app.zephyr-cloud.io) or [Chrome extension](https://chromewebstore.google.com/detail/zephyr-mission-control/liflhldchhinbaeplljlplhnbkdidedn):
+
+```bash
+rm -rf ~/.zephyr
+```
+
+</Steps>
+
diff --git a/docs/errors/ze10023.mdx b/docs/errors/ze10023.mdx
@@ -0,0 +1,52 @@
+---
+title: 'ZE10023: Invalid Module Federation config'
+description: 'ZE10023: Invalid Module Federation configuration detected'
+head:
+  - - meta
+    - property: og:description
+      content: 'ZE10023: Invalid Module Federation configuration detected'
+---
+
+import { getErrorMessage } from '../../lib/error-helpers.ts';
+import { ErrorInfo } from '../../components/errors/info.tsx';
+import { Steps } from '@rspress/core/theme';
+
+# {getErrorMessage('ZE10023')}
+
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
+<ErrorInfo code="ZE10023" terminal />
+
+This error occurs when your Module Federation configuration is invalid or missing required fields.
+
+## Debugging the error
+
+<Steps>
+
+### Check your Module Federation config
+
+Ensure your Module Federation configuration includes all required fields:
+
+```js
+new ModuleFederationPlugin({
+  name: 'myApp',
+  filename: 'remoteEntry.js',
+  exposes: {
+    './Component': './src/Component',
+  },
+  shared: ['react', 'react-dom'],
+})
+```
+
+### Verify the name field
+
+The `name` field is required and must be a valid JavaScript identifier (no spaces or special characters).
+
+### Check exposed modules
+
+Ensure paths in `exposes` are correct and the referenced files exist.
+
+</Steps>
+
diff --git a/docs/errors/ze10024.mdx b/docs/errors/ze10024.mdx
@@ -0,0 +1,46 @@
+---
+title: 'ZE10024: Invalid app ID'
+description: 'ZE10024: The provided application ID is invalid'
+head:
+  - - meta
+    - property: og:description
+      content: 'ZE10024: The provided application ID is invalid'
+---
+
+import { getErrorMessage } from '../../lib/error-helpers.ts';
+import { ErrorInfo } from '../../components/errors/info.tsx';
+import { Steps } from '@rspress/core/theme';
+
+# {getErrorMessage('ZE10024')}
+
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
+
+<ErrorInfo code="ZE10024" terminal />
+
+This error occurs when the application ID provided to Zephyr is invalid or doesn't match the expected format.
+
+## Debugging the error
+
+<Steps>
+
+### Verify the app ID format
+
+Application IDs should follow the expected format. Check your configuration to ensure the app ID is correctly specified.
+
+### Check your package.json
+
+Ensure your `package.json` has a valid `name` field, as this is often used to derive the application ID.
+
+### Clear local cache
+
+Try clearing the Zephyr cache and rebuilding:
+
+```bash
+rm -rf ~/.zephyr
+npm run build
+```
+
+</Steps>
+
diff --git a/docs/errors/ze10028.mdx b/docs/errors/ze10028.mdx
diff --git a/docs/errors/ze10029.mdx b/docs/errors/ze10029.mdx
@@ -12,14 +12,12 @@ import { ErrorInfo } from '../../components/errors/info.tsx';
 
 # {getErrorMessage('ZE10029')}
 
-<ErrorInfo code="ZE10029" terminal />
+::: tip Quick Help
+The fastest way to resolve this error is to [join our Discord](https://discord.gg/zephyrcloud) and leave a message - our team is ready to help!
+:::
 
-{/* TODO */}
+<ErrorInfo code="ZE10029" terminal />
 
 ::: warning
-
-Not documented yet. Had a problem and need help?
-
-Contact us in our [discord](https://discord.gg/zephyrcloud)!
-
+This error is not yet documented. Please contact us on Discord for assistance.
 :::