Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions app/layout.config.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -70,5 +70,10 @@ export const baseOptions: BaseLayoutProps = {
url: "https://codexeditor.app",
external: true,
},
{
text: "Status",
url: "https://status.codexeditor.com",
external: true,
},
],
};
19 changes: 18 additions & 1 deletion components/troubleshooting-flow.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -85,10 +85,12 @@ const troubleshootingPaths: TroubleshootingPath[] = [
'Use password reset if you already created an account.',
'Make sure the app has the permissions it requests.',
'Check your network if the issue involves sign-in or AI access.',
'Check the Codex Status page (status.codexeditor.com) to see if the servers are currently down.',
],
docs: [
{ title: 'Initial Setup', href: '/docs/getting-started/initial-setup' },
{ title: 'FAQ', href: '/docs/faq' },
{ title: 'Codex Status', href: 'https://status.codexeditor.com' },
],
},
{
Expand Down Expand Up @@ -152,12 +154,14 @@ const troubleshootingPaths: TroubleshootingPath[] = [
'Reload the project or editor window.',
'Check for updates and recent fixes related to sync or offline behavior.',
'Ask teammates whether they have synced recently if this is a shared project.',
'Check the Codex Status page (status.codexeditor.com) to see if the servers are currently down.',
],
docs: [
{ title: 'Sync Troubleshooting', href: '/docs/project-management/sync-troubleshooting' },
{ title: 'Sharing & Managing Projects', href: '/docs/project-management/sharing-managing-projects' },
{ title: 'How to Update Codex', href: '/docs/project-management/update-extensions' },
{ title: 'Release Notes', href: '/docs/releases/latest' },
{ title: 'Codex Status', href: 'https://status.codexeditor.com' },
],
},
{
Expand All @@ -177,11 +181,13 @@ const troubleshootingPaths: TroubleshootingPath[] = [
'Review your AI instructions and simplify them if needed.',
'Edit AI outputs to guide future suggestions.',
'Check whether the issue may be related to connectivity or a recent release.',
'Check the Codex Status page (status.codexeditor.com) to see if the AI services are currently down.',
],
docs: [
{ title: 'AI Settings', href: '/docs/translation/ai-settings' },
{ title: 'Translation Tools', href: '/docs/translation/translation-tools' },
{ title: 'Batch Translation', href: '/docs/translation/batch-translation' },
{ title: 'Codex Status', href: 'https://status.codexeditor.com' },
],
},
{
Expand Down Expand Up @@ -763,7 +769,18 @@ ${docsList}`;
</p>
)}

<div className="mt-6 grid gap-3 md:grid-cols-2">
<div className="mt-6 grid gap-3 md:grid-cols-3">
<a
href="https://status.codexeditor.com"
target="_blank"
rel="noopener noreferrer"
className="rounded-xl border border-fd-border bg-fd-background px-4 py-4 text-sm text-fd-foreground transition-colors hover:border-fd-primary/40 hover:bg-fd-primary/5"
>
<span className="block text-base font-semibold">Check server status</span>
<span className="mt-2 block text-fd-muted-foreground">
See if the Codex API services are currently up or experiencing issues.
</span>
</a>
<a
href="https://discord.gg/6kVJTEXYEp"
target="_blank"
Expand Down
3 changes: 2 additions & 1 deletion content/docs/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -298,7 +298,7 @@ Formats marked Beta are functional but may require manual review. Coming Soon fo

### Can I work offline?

Yes. Projects are stored locally on your device, allowing for offline work. Changes sync when you reconnect to the internet.
Yes. Projects are stored locally on your device, allowing for offline work. Changes sync when you reconnect to the internet. If sync seems stuck after reconnecting, check the **[Codex Status page](https://status.codexeditor.com)** to confirm the servers are up.

---

Expand Down Expand Up @@ -340,6 +340,7 @@ Browse our comprehensive documentation sections:

### How do I contact support?

- Check the **[Codex Status page](https://status.codexeditor.com)** first to see if the servers are experiencing issues
- Start with the [Troubleshooting guide](/docs/troubleshooting)
- Gather your Codex version, operating system, reproduction steps, expected vs actual behavior, and any console errors
- Use [Reporting Bugs](/docs/project-management/reporting-bugs) if you need help collecting the right evidence
Expand Down
7 changes: 4 additions & 3 deletions content/docs/project-management/reporting-bugs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,10 @@ When you encounter a bug in Codex, capturing error details helps the team diagno

Before escalating, make sure you have already:

1. Tried the closest path in the [Troubleshooting guide](/docs/troubleshooting)
2. Checked for updates using [How to Update Codex](/docs/project-management/update-extensions)
3. Reviewed the [latest release notes](/docs/releases/latest) to see whether the issue may already be fixed
1. Checked the **[Codex Status page](https://status.codexeditor.com)** to rule out a server outage
2. Tried the closest path in the [Troubleshooting guide](/docs/troubleshooting)
3. Checked for updates using [How to Update Codex](/docs/project-management/update-extensions)
4. Reviewed the [latest release notes](/docs/releases/latest) to see whether the issue may already be fixed

## Opening Developer Tools

Expand Down
9 changes: 5 additions & 4 deletions content/docs/project-management/sync-troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,10 @@ Codex syncs your project files to a remote server so your team can collaborate.

Make sure you are on the latest version of Codex before attempting any of the steps below. Many sync issues are fixed in newer releases.

1. Go to **Help > About Codex** and note your version.
2. Compare to the [latest release](/docs/releases/latest).
3. Update if needed, then check whether the sync issue persists.
1. Check the **[Codex Status page](https://status.codexeditor.com)** to see whether the servers are currently experiencing issues. If services are down, wait for them to recover before troubleshooting further.
2. Go to **Help > About Codex** and note your version.
3. Compare to the [latest release](/docs/releases/latest).
4. Update if needed, then check whether the sync issue persists.

---

Expand All @@ -38,7 +39,7 @@ The team will resolve this from the server side. Do not attempt to re-import or

If you have made changes but your teammates cannot see them:

1. Check your internet connection — sync requires a stable connection.
1. Check your internet connection — sync requires a stable connection. Also check the **[Codex Status page](https://status.codexeditor.com)** to confirm the servers are up.
2. In your project, look for the **Sync** button or indicator. Click it manually to trigger a sync.
3. Ask your teammates to also click Sync on their devices.
4. If sync is still not working after 10 minutes, check the **Console** in Developer Tools (Help > Toggle Developer Tools) for red error messages. Copy any errors you find.
Expand Down
Loading