# Docs Guides for installing Modifee, giving clients access, and fixing common problems. ## Getting started - [What is Modifee](https://www.modifee.com/docs/getting-started/what-is-modifee.md): A client describes a site change in the widget, and Modifee opens a pull request you can preview and merge. - [Quickstart](https://www.modifee.com/docs/getting-started/quickstart.md): Go from a new account to a merged test change on a connected GitHub repository. ## Install - [Next.js App Router](https://www.modifee.com/docs/install/nextjs-app-router.md): Add the widget script to the Next.js root layout, then confirm Widget install is complete. - [Next.js Pages Router](https://www.modifee.com/docs/install/nextjs-pages-router.md): Add the widget script to pages/_document, then confirm Widget install is complete. - [HTML and static sites](https://www.modifee.com/docs/install/html.md): Paste the widget script before the closing body tag on an HTML or static site, then confirm Widget install is complete. - [Other frameworks](https://www.modifee.com/docs/install/other-frameworks.md): Add the widget script on Vite, Astro, Flask, Django, Laravel, or Rails, then confirm Widget install is complete. ## Client access - [Auth methods](https://www.modifee.com/docs/client-access/auth-methods.md): Choose Site without login or App with login, and see what the client does before a request is accepted. - [Access marker](https://www.modifee.com/docs/client-access/access-marker.md): Choose the URL marker that shows the widget on a site without login, and replace the link when it changes. - [Allowed emails](https://www.modifee.com/docs/client-access/allowed-emails.md): Add or remove the people who can request changes, and send a test request from the agency. ## Vercel & previews - [Vercel integration](https://www.modifee.com/docs/vercel/integration.md): Install the Vercel integration, choose the project, and grant access when that project is missing from the list. - [Signing secret](https://www.modifee.com/docs/vercel/signing-secret.md): Store MODIFEE_SECRET, push it to Vercel Production and Preview, and regenerate it when the value must change. - [Redeploy](https://www.modifee.com/docs/vercel/redeploy.md): Redeploy production after MODIFEE_SECRET is pushed so the running site picks up the new value. - [Protected previews](https://www.modifee.com/docs/vercel/protected-previews.md): Open Vercel-protected preview deployments for clients, and leave other hosts on GitHub detection. ## Using the widget - [For clients](https://www.modifee.com/docs/widget/for-clients.md): How to ask for a site change in the widget, review the preview, and read the messages you may see. - [Voice dictation](https://www.modifee.com/docs/widget/voice-dictation.md): Dictate a widget request into the text box, and how that recording is billed. ## Agency workflow - [Inbox](https://www.modifee.com/docs/agency/inbox.md): What each request status asks you to do, and what the Test badge means. - [Quotes and merges](https://www.modifee.com/docs/agency/quotes-and-merges.md): Send a quote, see what the client gets, then merge, retry, or reject. - [Autopilot and limits](https://www.modifee.com/docs/agency/autopilot-and-limits.md): The Autopilot and limits settings, their defaults, and the plan's credits. - [Guardrails](https://www.modifee.com/docs/agency/guardrails.md): Paths the coding agent must not change, the defaults, and how to edit the list. - [Health indicators](https://www.modifee.com/docs/agency/health-indicators.md): The Home light, and the green or yellow mark on each project Settings section. ## Troubleshooting - [Symptom index](https://www.modifee.com/docs/troubleshooting/index.md): Match a symptom to a troubleshooting page, and the error codes that show up most often. - [Widget not showing](https://www.modifee.com/docs/troubleshooting/widget-not-showing.md): The change button never appears on the client site. - [Email not allowed](https://www.modifee.com/docs/troubleshooting/email-not-allowed.md): The widget refuses the client's email. - [Token errors](https://www.modifee.com/docs/troubleshooting/token-errors.md): App with login: the widget cannot verify the signed client token. - [Secret and redeploy](https://www.modifee.com/docs/troubleshooting/secret-and-redeploy.md): MODIFEE_SECRET is missing on Vercel, or a redeploy did not pick it up. - [Previews](https://www.modifee.com/docs/troubleshooting/previews.md): No preview was detected, the preview is protected, or the last check failed. - [Agent and pull request](https://www.modifee.com/docs/troubleshooting/agent-and-pr.md): The agent failed, no pull request was opened, or a monthly limit stopped the request. - [Billing and plan](https://www.modifee.com/docs/troubleshooting/billing-and-plan.md): A plan limit, a missing billing account, a checkout that did not open, or the project's monthly request cap. ## Errors - [Error catalog](https://www.modifee.com/docs/errors.md): Every Modifee error code, with what caused it and how to fix it. - [MDF-AUTH-001](https://www.modifee.com/docs/errors/MDF-AUTH-001.md): You need to sign in. - [MDF-AUTH-002](https://www.modifee.com/docs/errors/MDF-AUTH-002.md): This email isn't allowed to request changes on this site. - [MDF-AUTH-003](https://www.modifee.com/docs/errors/MDF-AUTH-003.md): You don't have access to this. - [MDF-AUTH-004](https://www.modifee.com/docs/errors/MDF-AUTH-004.md): That code is incorrect or has expired. - [MDF-AUTH-005](https://www.modifee.com/docs/errors/MDF-AUTH-005.md): Too many attempts. Request a new code. - [MDF-REQ-001](https://www.modifee.com/docs/errors/MDF-REQ-001.md): Something was off with that request. - [MDF-REQ-002](https://www.modifee.com/docs/errors/MDF-REQ-002.md): We couldn't find that. - [MDF-REQ-003](https://www.modifee.com/docs/errors/MDF-REQ-003.md): That conflicted with the current state. - [MDF-REQ-004](https://www.modifee.com/docs/errors/MDF-REQ-004.md): You've used the adjustments included with this change. - [MDF-QUOTA-001](https://www.modifee.com/docs/errors/MDF-QUOTA-001.md): Request received — your team has been notified and will process it shortly. - [MDF-QUOTA-002](https://www.modifee.com/docs/errors/MDF-QUOTA-002.md): Too many requests. Try again in a moment. - [MDF-QUOTA-003](https://www.modifee.com/docs/errors/MDF-QUOTA-003.md): Too many codes requested. Try again in a few minutes. - [MDF-PLAN-001](https://www.modifee.com/docs/errors/MDF-PLAN-001.md): This workspace is over its plan limit. - [MDF-PLAN-002](https://www.modifee.com/docs/errors/MDF-PLAN-002.md): This workspace has no billing account yet. - [MDF-PLAN-003](https://www.modifee.com/docs/errors/MDF-PLAN-003.md): Billing could not be opened. - [MDF-PLAN-004](https://www.modifee.com/docs/errors/MDF-PLAN-004.md): You've reached this month's request limit. Your team can raise it. - [MDF-WIDGET-001](https://www.modifee.com/docs/errors/MDF-WIDGET-001.md): That file could not be attached. - [MDF-WIDGET-002](https://www.modifee.com/docs/errors/MDF-WIDGET-002.md): Transcription failed. - [MDF-WIDGET-003](https://www.modifee.com/docs/errors/MDF-WIDGET-003.md): The sign-in email could not be sent. - [MDF-WIDGET-004](https://www.modifee.com/docs/errors/MDF-WIDGET-004.md): Allow the microphone in your browser to dictate. - [MDF-WIDGET-005](https://www.modifee.com/docs/errors/MDF-WIDGET-005.md): The connection was lost. - [MDF-VERCEL-001](https://www.modifee.com/docs/errors/MDF-VERCEL-001.md): Vercel could not complete that request. - [MDF-VERCEL-002](https://www.modifee.com/docs/errors/MDF-VERCEL-002.md): The preview signing secret is missing or was not saved. - [MDF-VERCEL-003](https://www.modifee.com/docs/errors/MDF-VERCEL-003.md): The preview could not be opened. - [MDF-INTERNAL-001](https://www.modifee.com/docs/errors/MDF-INTERNAL-001.md): Something broke on our end. We've been notified. - [MDF-INTERNAL-002](https://www.modifee.com/docs/errors/MDF-INTERNAL-002.md): Modifee is briefly unavailable.