Ask Netlify
Our chatbot assistant can quickly answer your questions.

JavaScript SPAs

Netlify supports many frameworks and project architectures. On this page, you'll find generic common configuration information for JavaScript single-page applications (SPAs). For framework-specific configurations, refer to our frameworks page.

# Build configuration for JavaScript SPAs

Most SPAs declare a build command in the scripts array of the project’s package.json file. To run this script in Netlify, set the Build command to npm run YOUR_BUILD_SCRIPT or yarn YOUR_BUILD_SCRIPT, depending on your chosen JavaScript dependency manager.

The Publish directory for single-page apps is often called dist but varies by framework and build tool. You can check the framework documentation, or try running the build script locally, then check what folder was created as a result.

Avoid 404s for SPAs

If your project is a single page app (SPA) that uses the history pushState method to get clean URLs, you must add a rewrite rule to serve the index.html file no matter what URL the browser requests.

# More build configuration resources