Help for check results
The DeployAI check marks anything that would stop your site or slow it down. Each one is explained here in plain words, with a ready prompt for your agent.
Blockers
Any of these stops the deploy, until your agent fixes it and runs the check again.
- Writes files to diskThe site saves files in a folder on the server, such as images that visitors upload or a file with data.
- PostgreSQL is not supported, use the built in databaseThe site keeps its data in a PostgreSQL database that runs on a separate server.
- MySQL is not supported, use the built in databaseThe site keeps its data in a MySQL database that runs on a separate server.
- MongoDB is not supported, use the built in databaseThe site keeps its data in MongoDB, a database that runs on a separate server.
- Local SQLite file database, use the built in databaseThe site keeps its data in a database file inside the project.
- sharp used at runtimeThe site uses the sharp library to process images while the site runs.
- bcrypt is a native moduleThe site uses the bcrypt library to store passwords safely.
- Native binary moduleThe site uses a library built from native code for a specific machine, not only JavaScript.
- Long-running or background processThe site starts something that keeps running in the background, such as a timer, a job queue or a scheduled task.
- Runs a WebSocket serverThe site runs a WebSocket server, an open connection that stays up to send live updates.
- Project is too large to uploadThe files that upload with the site weigh more than 50 MB.
- Astro server pages need the adapterThe site is built with Astro, but the official adapter that prepares it for our servers is missing.
- SvelteKit adapter is missingThe site is built with SvelteKit, but the official adapter that prepares it for our servers is missing.
- React Router adapter is missingThe site is built with React Router, but the official adapter that prepares it for our servers is missing.
- Hono starts a Node serverThe site is built with Hono, but started as a server that listens on a port.
- Next.js needs the OpenNext adapterThe site is built with Next.js, but the official adapter that prepares it for our servers is missing.
- SolidStart preset is missingThe site is built with SolidStart, but the official adapter that prepares it for our servers is missing.
- Qwik City adapter is missingThe site is built with Qwik City, but the official adapter that prepares it for our servers is missing.
- TanStack Start adapter is missingThe site is built with TanStack Start, but the official adapter that prepares it for our servers is missing.
- .env file is committed to gitAn env file with passwords and keys is saved in git, the version history of the code.
- Secret key in source codeA secret key, such as an API key or a password, is written straight into the code.
- Runs shell commands (child_process)The site runs system commands or other programs from its code.
- Runs its own Node serverThe site starts its own server that listens on a port, for example with Express.
- Built with a tool our hosting does not run, it needs rebuildingThe site is built with a tool we do not run, such as WordPress, PHP or Python.
- Nothing to upload in this folderThis folder has no site files.
Warnings
The site goes live with these too, but they are worth fixing.
- No build script in package.jsonpackage.json has no build command, the command that builds the site.
- Framework not recognizedWe could not tell which tool the site is built with.
- Framework support is in betaThe site is built with a tool whose support on DeployAI is still in beta.
- Astro adapter is not supportedThe site is built with Astro, but set up with an adapter for a different kind of server.
- Page has no language setA page on the site does not say which language it is in.
- Hebrew or Arabic page is not set to right to leftA Hebrew or Arabic page is not set to read right to left.
- Images without alt textThe site has images with no alt text, a short description of what the image shows.
- Form fields without a labelA form has fields with no label that says what to fill in.
- Buttons without a nameThe site has buttons with no name, usually buttons that show only an icon.
- Links without a nameThe site has links with no name, usually links with only an icon or an image without a description.
- Headings skip a level or the page has no main headingThe headings on a page skip a level, for example from a subheading straight to a fourth level heading, or the page has no main heading.
- Embedded frames without a titleThe site has embedded content, like a map or a video, with no title that says what it shows.
- Custom tab order with a positive tabindexThe site has elements that force a custom order for the Tab key.
- Zoom is blocked on mobileThe site blocks zooming in on phones.
- Media plays sound on its ownThe site has video or audio that starts on its own with sound.
- No skip to content linkThe home page does not start with a "Skip to content" link that goes straight to the main content.
- No accessibility statement linked from the home pageWe did not find an accessibility statement on the site, or the home page does not link to it.
- Accessibility statement is missing detailsThe accessibility statement is missing details: the date of the last update, a phone or email, or the name of the accessibility coordinator.
Need help? Talk to us