Prerequisites
Before you begin, ensure you have:- Node.js (version 16 or higher)
- npm package manager
Local development
Production build
To create a production-ready build:Build the application
Generate optimized production assets:This compiles and minifies your application for deployment.
Deployment
The project is configured for automatic deployment:- Vercel: Automatically deploys preview builds on pull requests and production builds from the
mainbranch - GitHub Actions: Runs build validation and tests on every push and pull request
Available scripts
| Script | Description |
|---|---|
npm run dev | Start development server on port 8080 |
npm run build | Build for production |
npm run preview | Build and preview production version |
npm run check | Run TypeScript checks and build |
npm run lint | Run ESLint code linting |
npm run test | Run Playwright tests |
Troubleshooting
If you encounter issues:- Port already in use: The default port is 8080. If it’s occupied, the development server will use an alternative port
- Dependencies not installing: Clear your
node_modulesfolder andpackage-lock.json, then runnpm installagain - Build errors: Run
npm run checkto identify TypeScript errors before building