> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# When a Build Fails: Ask AI, Then Verify

> Find the failed environment's error, ask AI to check the current files, and verify a fresh build before choosing to deploy

A failed build is a reason to investigate, not a reason to keep pressing **Deploy**. Find the error for the right environment, ask the builder AI to check your **current** files, and verify what happens on a fresh build. This Northwind Coffee Roasters example ended with a passing check—without a code change or a deployment.

<video controls playsInline preload="metadata" aria-label="When a Build Fails: Ask AI, Then Verify video walkthrough" poster="/images/how-tos/site-builder/fix-failed-build-video-poster.webp" src="https://hiveku-media-assets.s3.us-east-2.amazonaws.com/b1614719-6f04-4647-a842-74936fcb9c28/ebebaa43-7432-4c8a-aaaa-4fc757a3028c.mp4" />

> **Read the video transcript**
>
> When a build fails, start with the error—not another Deploy.
>
> From your Hiveku dashboard, open Websites.
>
> Choose Northwind Coffee Roasters.
>
> In Hosting's Development history, the failed run points to a TypeScript error on the blog page.
>
> Share the error in chat, or ask why the Development build failed. Have the AI inspect current files before changing anything.
>
> The AI compares the current blog page and Nav component. That prop already exists, so it avoids a guesswork fix.
>
> Next it runs a fresh build check on the saved project, without publishing the site.
>
> We'll pause here while the real build finishes.
>
> The fresh check passed. That earlier error didn't reproduce against the current files, and the chat changed no code.
>
> A passing build isn't a deployment. Your live site is untouched.
>
> Now expand Deploy at the top right. Development and Production have separate rows for status and changes.
>
> The little terminal icon opens Build Logs.
>
> Recent runs appear here. Open a row for details.
>
> If yours still fails, fix the current error. Verify before you deploy.

> [!NOTE]
>
> This video shows a **historical failed Development build** followed by a **new non-deploy build check that passed**. It does not show AI editing the site or a successful deployment to Development or Production. A failed entry remains in history even after a later check passes.

## Find the error for the right environment

**1. Open the site and check its environment**

From your Hiveku dashboard, click **Websites** and open the site. In the builder, expand **Deploy** at the top right. **Development** and **Production** have separate rows, statuses, and change counts; **Staging** appears when enabled. Opening this menu does **not** deploy anything. Do not press a row's **Deploy** button just to inspect a failure.

**2. Look in the recent Build Logs**

Click the small **terminal icon** in the Deploy menu's footer. The bottom Build Logs panel shows recent runs across environments. Select a run to read its details. Because this panel keeps only the most recent entries across environments, the failed run you need may no longer be listed there.

**3. Open the failed environment's history**

On the site's **Hosting** page, select the environment that failed—**Development** in this example. Scroll to **Deployment History**, expand **Recent Deployments**, and find the entry marked **Failed**. Read its **Build Error** and, if needed, expand **View Full Build Logs**. [Read Your Build and Site Logs](https://docs.hiveku.com/how-tos/site-builder/read-your-logs.md) shows this screen in more detail.

Northwind's older Development build reported `./app/blog/page.tsx:20:12`: the blog page passed `overDarkHero` to `Nav`, but that build did not recognize the prop. This error identifies **that build's** problem; it does not prove the same error still exists in the saved project today.

## Ask AI to check the current files

In the builder chat, share the meaningful file, line, and error—not a giant build-command transcript. You can also ask, “Why did my Development build fail?” and let the AI inspect the logs. A precise request for this example is:

```text wrap theme={null}
My Development build failed at ./app/blog/page.tsx:20:12. It said the overDarkHero prop isn't accepted by Nav. Check the CURRENT blog page and Nav component before changing anything. Run a fresh non-deploy build or typecheck. If it still fails, fix only the current build errors and check again. Tell me which files changed and whether the final check passed. Do not deploy or publish.
```

The filmed request also told the AI not to change site copy or design and not to use paid models. If a failed log offers **Ask AI to Fix**, review your model and the request first: that shortcut sends a request automatically.

## Wait for an actual verdict

The chat may show many small steps as it reads files and runs a build. You don't need to react to each one. Wait until the check has **finished**, then read both the AI's result and the newer build record for that same environment. A message saying the build *started* is not proof that it passed.

In this case, the current `Nav` component already accepted `overDarkHero`. The fresh non-deploy Development check **passed**; the AI changed **no files**. It would have been wrong to edit working code just to recreate the historical error.

> [!WARNING]
>
> **A passing check is not a deployment.** The video never presses Deploy. It does not put a new version on Development or Production, and it does not change what visitors see. A green row from a different recent run is not proof of *this* check—compare the run's environment and time.

## If your current check still fails

Ask the AI to fix the **error that reproduced now**, review the files it changed, and have it rerun the build or typecheck. If the new check passes and you're ready to put changes on a site copy, expand **Deploy** and choose the intended environment deliberately. [Check on Development First](https://docs.hiveku.com/how-tos/site-builder/check-on-development.md) explains the test copy; [Publish Your Changes](https://docs.hiveku.com/how-tos/site-builder/publish.md) explains Production. If the error points to Hiveku infrastructure rather than your code, keep the failed run's details and contact support instead of guessing at an edit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.