Choorai
Frontend Hosting

Netlify Deployment Guide

Deploy React/Vite apps with Git integration and configure SPA rewrites for route safety.

TL;DR

  • Connect GitHub repository
  • Set build command and publish directory
  • Apply SPA rewrite via _redirects or netlify.toml

1Baseline build setup

Netlify Build
Build command: npm run build
Publish directory: dist

2Configure SPA rewrites

public/_redirects
/*    /index.html   200

Why this matters

Prevents 404 when users directly open client-side routes.

3Post-deploy validation

  • Check root and deep-link routes
  • Validate environment variable injection
  • Review build logs for warnings/errors

TL;DR

  • Use this section as a quick baseline for Netlify deployment.
  • Replace branch names, secrets, URLs, and thresholds with your team-specific values.

Prerequisites

  • Confirm repository and runtime access permissions.
  • Verify baseline commands (`install`, `build`, `test`) for local/CI.
  • Ensure environment variables, secrets, and deployment targets are up to date.

Steps

  1. Lock the change goal and scope in one sentence.
  2. Apply the core Netlify deployment changes in minimal commits.
  3. Capture validation logs and immediately update checklist/docs.

Validation

  • Confirm build/test pass reproducibly on the current branch.
  • Run manual sample checks on critical user/operation flows.
  • Cross-check ko/en docs and links for intent consistency.

Troubleshooting

  • Capture logs, request payloads, and environment values first on failures.
  • Narrow down by permissions, env vars, routing, and build artifacts.
  • Record temporary mitigation and root-cause fix separately.

References

Last updated: February 22, 2026 · Version: v0.0.1

Send Feedback

Opens a new issue page with your message.

Open GitHub Issue