- Duty Limits Calculator: Interactive tools for calculating maximum duty limits
- Fatigue Management: Evidence-based fatigue assessment and management recommendations
- Rest & Recovery: Comprehensive rest requirement calculations
- Mobile Responsive: Full functionality on phones, tablets, and desktop computers
- Dark Mode: Eye-friendly interface for night operations
- Offline Support: Progressive Web App (PWA) capabilities for use without internet
- Privacy First: All calculations performed locally - no personal data transmitted
- Visit the Live Application: https://scheduling.fdx.alpa.org/
- Install as Mobile App:
- On iOS: Tap the share button and select "Add to Home Screen"
- On Android: Tap the menu button and select "Install App"
- Start Using Tools: Navigate to Duty Limits or Fatigue sections to begin
Before you begin, you'll need to install:
- Node.js (version 18 or higher) - Download here
- npm (comes with Node.js) - Package manager for JavaScript
- Git - Download here for version control
-
Clone the repository (download the code to your computer):
git clone https://github.com/your-username/sched-committee.git cd sched-committee -
Install dependencies (download all required packages):
npm install
This command reads the
package.jsonfile and installs all necessary libraries and tools. -
Start the development server:
npm run dev
Your application will be available at
http://localhost:3000
| Command | Purpose | When to Use |
|---|---|---|
npm run dev |
Start development server | When actively coding and testing |
npm run build |
Build for production | Before deploying to production |
npm run preview |
Preview production build locally | To test production build before deployment |
npm run test |
Run unit tests | To verify code functionality |
npm run lint |
Check code quality | Before submitting contributions |
npm run lint:fix |
Auto-fix code style issues | To automatically resolve style problems |
We maintain high code quality through comprehensive testing:
Tests individual functions and components:
npm run testEvery pull request automatically creates a preview deployment for testing:
https://gentle-grass-0608be90f-<pull-request-number>.eastus2.5.azurestaticapps.net/
For example, for pull request #38, the preview URL would be:
https://gentle-grass-0608be90f-38.eastus2.5.azurestaticapps.net/
This project includes native mobile app capabilities using Capacitor. This capability is unused, as we decided to build a Progressive Web App (PWA) instead to leverage the compatibility and performance benefits of web technologies. However, the mobile app can be built and run for testing purposes or for future use.
-
Generate static files and sync with native projects:
npm run sync
This is equivalent to running:
npm run generate # Build static files npx cap sync # Sync with native projects
-
Run on iOS Simulator (macOS only):
npx cap run ios
-
Run on Android Emulator:
npx cap run android
- Nuxt.js 3 - Vue.js framework for production-ready applications
- Vue.js 3 - Progressive JavaScript framework
- TypeScript - Type-safe JavaScript for better development experience
- Tailwind CSS - Utility-first CSS framework
- Nuxt UI - Beautiful and accessible UI components
- Heroicons - Professional SVG icons
- Vitest - Lightning fast unit testing
- Playwright - Reliable end-to-end testing
- ESLint - Code quality and consistency
We welcome contributions from everyone. Whether you're fixing a bug, adding a feature, or improving documentation, your help makes us better.
- Fork the repository on GitHub
- Create a new branch for your feature:
git checkout -b feature/your-feature-name
- Make your changes and test thoroughly
- Run the linter to ensure code quality:
npm run lint:fix
- Run tests to verify functionality:
npm run test - Commit your changes with a clear message:
git commit -m "Add feature: your feature description" - Push to your fork and create a pull request
- Code Quality: Follow the existing code style and run linting tools
- Testing: Add tests for new features and ensure existing tests pass
- Documentation: Update README and code comments for significant changes
sched-committee/
├── components/ # Reusable Vue components
│ ├── dutyLimits/ # Duty calculation components
│ ├── fatigue/ # Fatigue management components
│ └── restRecover/ # Rest requirement components
├── pages/ # Application routes/pages
├── composables/ # Reusable logic functions
├── utils/ # Helper functions and utilities
├── tests/ # Unit and integration tests
├── assets/ # Images, styles, and static assets
└── docs/ # Additional documentation
- Production: Automatically deployed when code is merged to
mainbranch - Preview: Each pull request gets its own preview deployment for testing
-
Build the application:
npm run build
-
Deploy static files from the
dist/directory to your hosting provider
Supported platforms:
- Azure Static Web Apps
- Vercel
- Netlify
- GitHub Pages
- Any static hosting provider
This project is licensed under the AGPL License - see the LICENSE file for details.
- GitHub Discussions: For questions and community support
- Bug Reports: Use GitHub Issues for reporting problems
- Development Wiki - Detailed technical documentation
'TERMS OF USE', 'The FedEx MEC Scheduling Committee (“Committee”) App is provided as a convenience for the members of the ALPA FedEx MEC. The App consists of a Duty Limit section and a section devoted to fatigue and its effects; the latter service is provided for educational purposes only. Neither section shall be construed as offering individual legal advice, and the use of the App does not absolve individual members of their responsibility to adhere to the terms and conditions of the FedEx/ALPA Collective Bargaining Agreement, the FARs, or their personal fitness for duty self-assessment. INFORMATION OBTAINED FROM THE APP SHOULD NOT BE RELIED UPON FOR PERSONAL, MEDICAL OR LEGAL DECISIONS AND YOU SHOULD CONSULT AN APPROPRIATE PROFESSIONAL FOR SPECIFIC ADVICE TAILORED TO YOUR SITUATION.', 'MODIFICATION OF THE APP', 'The FedEx MEC Scheduling Committee reserves the right to change the terms, conditions, or content of this App, including suspending or terminating its operation without prior notice.', 'EXPRESS LIABILITY DISCLAIMER', 'While the Committee strives to provide accurate information to its members, the Committee, FedEx MEC, and/or ALPA make no representation to the suitability, reliability, availability, timeliness or accuracy of the results derived from this App’s usage, and assumes no liability for any damages, claims, or losses, incurred as a result using the App. User agrees to assume all risks and any liability which may result from using the App.'
The FedEx MEC Scheduling Committee (“Committee”) is committed to respecting and protecting the privacy of its members. The Committee has adopted a set of guidelines that serve as the basis for the relationship between member data and the Committee’s Flight Time/Duty Time App. While these guidelines have been developed with the recognition that Internet technologies rapidly change, currently the use of the Committee’s Flight Time/Duty Time Appdoes not request or require personal member information and as such, no member information is stored on the App’s server. Should future versions of this App require the disclosure of personal information, users will be notified of such a change, and will be directed to view the Committee’s revised Privacy Policy.