---
title: "Discussion on \"Why Your React App Breaks When You Refresh on Vercel (And the 2-Minute Fix)\" | Hashnode"
description: "Discussion on \"Why Your React App Breaks When You Refresh on Vercel (And the 2-Minute Fix)\". Deployed a React app to Vercel and seeing a 404 error when refreshing routes? Here’s why it happens, and the simple fix using a vercel.json file."
url: "https://hashnode.com/posts/why-does-my-react-app-break-when-i-refresh-the-page-on-vercel/687ead3dfe998df3f6413a94"
---

[Feed](https://hashnode.com/feed) /

Discussion

# [Why Your React App Breaks When You Refresh on Vercel (And the 2-Minute Fix)](https://abraham-bishop.hashnode.dev/why-does-my-react-app-break-when-i-refresh-the-page-on-vercel?utm_source=hashnode&utm_medium=feed)

Deployed a React app to Vercel and seeing a 404 error when refreshing routes? Here’s why it happens, and the simple fix using a vercel.json file.

Jul 21, 2025 · 3 min read · abraham-bishop.hashnode.dev  
Updated Oct 10, 2025  
Read the article

-   [#vercel](https://hashnode.com/tag/vercel)
-   [#404-page](https://hashnode.com/tag/404-page)
-   [#reactjs](https://hashnode.com/tag/reactjs)
-   [#react-router](https://hashnode.com/tag/react-router)
-   [#deployment](https://hashnode.com/tag/deployment)
-   [#routing](https://hashnode.com/tag/routing)
-   [#client-side-rendering](https://hashnode.com/tag/client-side-rendering)

## Written by

[Bishop Abraham](https://hashnode.com/@code-with-bishop)

@code-with-bishop

  
[View profile](https://hashnode.com/@code-with-bishop)

I solve real-life problems with code

Full-stack developer and co-founder at Skybil. Over 4 years solving real problems with code. I build platforms that improve business metrics and deliver measurable results. When I'm not coding, I'm reading about entrepreneurship or exploring new areas of computer science. Currently working on multiple startup projects. This blog documents what I'm learning along the way.

## Responses

Markdown supported · ⌘↵ to post

No responses yet.
