dzinesco
aa81eb5adb
- Add comprehensive analytics components with export functionality - Implement territory management with manager performance tracking - Add seatmap components for venue layout management - Create customer management features with modal interface - Add advanced hooks for dashboard flags and territory data - Implement seat selection and venue management utilities - Add type definitions for ticketing and seatmap systems 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# Development Setup
|
|
|
|
## Important: No Sudo Required
|
|
|
|
This project is designed to run entirely without sudo/root privileges. All development and testing commands should work with regular user permissions.
|
|
|
|
### Key Points:
|
|
|
|
1. **Package Installation**: Use `npm install` (never `sudo npm install`)
|
|
2. **Test Execution**: All test commands run without sudo
|
|
3. **Development Server**: Runs on user ports (5173 by default)
|
|
4. **Playwright**: Browsers install to user directories
|
|
|
|
### If You Encounter Permission Issues:
|
|
|
|
- **Node/NPM**: Use a node version manager (nvm, fnm) instead of system-wide installation
|
|
- **Browsers**: Playwright will install browsers to `~/.cache/ms-playwright`
|
|
- **Ports**: Development server uses port 5173+ (above 1024, no privileges needed)
|
|
|
|
### Environment Configuration:
|
|
|
|
```bash
|
|
# Set custom port if needed (optional)
|
|
export PORT=3000
|
|
|
|
# Run development server
|
|
npm run dev
|
|
|
|
# Run tests (no sudo needed)
|
|
npm run test:smoke
|
|
```
|
|
|
|
### Troubleshooting:
|
|
|
|
If you see permission errors:
|
|
1. Check your Node.js installation (should not require sudo)
|
|
2. Clear npm cache: `npm cache clean --force`
|
|
3. Remove node_modules and reinstall: `rm -rf node_modules && npm install`
|
|
4. For Playwright issues: `npx playwright install` (user-level install)
|
|
|
|
### System Dependencies (One-time setup):
|
|
|
|
If you see browser dependency errors, you may need to install system dependencies:
|
|
|
|
```bash
|
|
# For Ubuntu/Debian - this is the ONLY case where sudo may be needed
|
|
# (for system-level browser dependencies, not the project itself)
|
|
sudo npx playwright install-deps
|
|
|
|
# Alternative approach - manual dependency installation
|
|
sudo apt-get install libavif16
|
|
```
|
|
|
|
**Important**: The system dependencies are for browser support only. All project development commands should still run without sudo.
|
|
|
|
**Never use sudo for any project development or testing commands - only for one-time system dependency installation if needed.** |