Troubleshooting

Top-level /index.html missing

This warning occurs when Stormkit is not able to find a top-level /index.html file and server side rendering is not detected. This does not necessarily mean that your deployment failed. It just means that your endpoint's root path returns 404. Other uploaded files will still return correctly.

To view your deployment package, find your deployment from Deployments list, expand the menu and click on the Manifest button. The CDN Files section contains a list of deployed files.

If the deployed files are not the correct ones, you can change the output folder by modifying the environment configuration's Output option and re-deploy.

If you need a dynamic application you will need to enable Server Side Rendering. For Nuxt.js, we detect server side rendering automatically. For Next.js, we only support static applications. To enable server side rendering for other applications, your build must generate a .stormkit/server folder with a file called server.js. The file must export a method called handler like below:

// .stormkit/server/server.js

export const handler = ({ req, res }) => {
    res.write("hello world");
    res.end();
}

You'll probably need a bundler like Vite to bundle your application to .stormkit/server/server.js.

When server side rendering is enabled, all requests not matching a CDN file will be forwarded to serverless handler. When it is not enabled, Stormkit expects to find a file for the endpoint and returns 404 otherwise.

Repository is inaccessible

This error occurs when Stormkit has no access to the repository. There may be two reasons for this:

The repository URL is changed

  1. Visit your application
  2. Click on the Gear icon and navigate to Settings page
  3. Change the Repository URL accordingly by pasting the https URL
  4. If the problem persists, see next step.

Credentials are either expired or invalid

GitHub

If you're using a GitHub repository, you'll need to grant access to the Stormkit App. To do so:

  1. Visit https://app.stormkit.io
  2. Click on Create new app
  3. Click on Connect more repositories
  4. Grant access to the repository
  5. Once the popup is closed, navigate to your application and try to re-deploy.

GitLab

  1. Visit gitlab.com and login to your account
  2. Click on your Avatar > Preferences > Applications
  3. Revoke anything related to Stormkit
  4. Visit https://app.stormkit.io
  5. Make sure to login with GitLab - it will ask you to re-authorize
  6. Go back to your application and try to re-deploy

Cannot find my app

If you logged in with different providers and they are registered through different emails, Stormkit will create an account for each provider with different email. If you need to migrate your apps between accounts, reach us out from Discord or email.

Branch does not exist

If you see a "Stormkit has no access to the repo or the branch does not exist." error, it may be because Storkmit cannot checkout the branch. The branch may be deleted or never existed before. If you are sure that the branch is existing and you still receive this error, try to follow the steps described in Repository is inaccessible.