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>
1.9 KiB
1.9 KiB
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:
- Package Installation: Use
npm install(neversudo npm install) - Test Execution: All test commands run without sudo
- Development Server: Runs on user ports (5173 by default)
- 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:
# 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:
- Check your Node.js installation (should not require sudo)
- Clear npm cache:
npm cache clean --force - Remove node_modules and reinstall:
rm -rf node_modules && npm install - 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:
# 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.