Page Guides - Master Index
Page Guides - Master Index
Navigation guides for all pages in the Shifty application
This directory contains screen-by-screen navigation guides for every major page in Shifty. Each guide shows:
- How to reach the page - Breadcrumb and step-by-step navigation
- Page layout - Key areas and their purpose
- Available actions - What you can do on the page
- Screenshots - Visual references (placeholders for browser-captured images)
- Related pages - Connected features and workflows
Quick Find
By Role:
- Admin Pages - Calendar, management, time tracking
- Employee Pages - Dashboard, availability, applications
- System Pages - Login, profile, settings
By Category:
- Calendar & Planning (2 guides)
- Management (3 guides)
- Communication (1 guide)
- Time & Statistics (2 guides)
- Employee Self-Service (3 guides)
- System & Settings (3 guides)
- Settings (1 guide)
Admin Pages
Administrative interfaces requiring Expediter+ or Admin role
Calendar
Admin Calendar (Expediter, Admin, Developer) Split-view planning interface with Events Grid (top) and Staff Grid (bottom). Drag-and-drop assignment, weekly overview, Day Planning Kanban mode.
- URL:
/admin/planning - Key Features: Event columns, employee rows, assignment chips, drag-and-drop, filters
- Main Actions: Create events, assign employees, finalize schedule, view day planning
- Lines: 270
Employee Calendar (All Roles) Personal calendar showing your assigned shifts. Three view modes: Week (time grid), Month (overview), List (detailed).
- URL:
/schedule - Key Features: Week/Month/List views, shift details, color coding, iCal export
- Main Actions: View shifts, export calendar, filter by type, download iCal subscription
- Lines: 301
Management
User Management (Admin, Developer) Create, edit, and manage employee accounts. Bulk operations, filtering by team/position/role, activation/deactivation.
- URL:
/admin/users - Key Features: User table, filter panel, bulk actions, export
- Main Actions: Add user, edit details, deactivate/activate, reset password, export list
- Lines: 248
Event Management (Admin, Expediter, Developer) Create and manage events with lifecycle tracking (Draft → Upcoming → Past → Archived). Duplicate events for similar occasions.
- URL:
/admin/events - Key Features: Event cards/list view, status filters, duplication, archival
- Main Actions: Create event, edit details, duplicate, archive, view in calendar
- Lines: 278
News Management (Admin, Developer) Publish news articles for employees. Rich text editor, scheduled publishing, article pinning.
- URL:
/admin/news - Key Features: Article editor, scheduling, pinning, team visibility
- Main Actions: Create article, publish immediately, schedule, pin to top, unpublish
- Lines: 260
Communication
Messaging (Admin, Developer) Send targeted messages to employees. Template system, recipient targeting, message history with read receipts.
- URL:
/admin/messaging - Key Features: Compose form, templates, recipient targeting, history, read tracking
- Main Actions: Compose message, use template, select recipients, schedule send
- Lines: 123
Time & Statistics
Time Tracking (Admin, Expediter, Developer) Review and approve employee time records. Edit entries, bulk approval workflow, manual entry creation.
- URL:
/admin/time-tracking - Key Features: Time records table, approval workflow, bulk operations, filtering
- Main Actions: Review records, approve/reject, bulk approve, edit times, create manual entry
- Lines: 158
Statistics (Admin, Expediter, Developer) Generate reports on employee hours and assignments. Multiple report types, export formats (Excel/PDF/CSV).
- URL:
/admin/statistics - Key Features: Report types (Hours, Assignments, Availability), data grid, summary cards, exports
- Main Actions: Select report type, filter data, export to Excel/PDF/CSV, schedule reports
- Lines: 175
Employee Pages
Self-service interfaces for all employees
Employee Dashboard (All Roles) Personal homepage showing upcoming shifts, news feed, quick stats, and action buttons. Widget-based layout.
- URL:
/dashboard - Key Features: Upcoming Shifts widget, News Feed, Quick Stats, Calendar Preview
- Main Actions: View shifts, mark availability, apply to shifts, read news, navigate to full calendar
- Lines: 129
Availabilities (All Roles) Mark when you're available to work. Weekly grids with checkboxes, time preferences, submission deadlines.
- URL:
/employee/availabilities - Key Features: Month selector, weekly grids, time preferences, notes, submission status
- Main Actions: Check available days, set time preferences, copy previous month, submit availability
- Lines: 80
Applications (All Roles) Browse and apply for open shifts. Track application status (Pending/Approved/Rejected).
- URL:
/employee/applications - Key Features: Available Shifts tab, My Applications tab, filters, status badges
- Main Actions: Browse shifts, apply to shift, withdraw application, filter by date/position
- Lines: 101
System Pages
Core system pages accessible to all users
Login (Public) Authentication page with email/password login. Password reset flow, 2FA support, language selection.
- URL:
/auth/login - Key Features: Login form, "Forgot Password" link, Remember Me, language selector
- Main Actions: Log in, reset password, enable 2FA, select language
- Lines: 178
User Profile (All Roles) View and edit personal information. Tabs for Personal Info, Security, Notifications, Preferences. Avatar upload, password change, 2FA setup.
- URL:
/profile - Key Features: Profile header with avatar, tabs (Personal/Security/Notifications/Preferences)
- Main Actions: Edit personal info, change password, enable 2FA, configure notifications, set language/timezone
- Lines: 209
Settings
Settings (Admin, Developer) Configure system-wide application settings. Category tabs for General, Team, Notifications, Security, Advanced.
- URL:
/admin/settings - Key Features: Category tabs, settings forms, save/reset buttons
- Main Actions: Configure general settings, manage team settings, set notifications, security options, advanced config
- Lines: 142
Usage
For End Users
- Find your page using the categorized lists above
- Click the link to open the full page guide
- Follow the navigation steps to reach the actual page in Shifty
- Refer to available actions to understand what you can do
For Documentation Contributors
Creating New Page Guides:
- Follow the template structure established in existing guides
- Include: frontmatter, Quick Reference table, How to Reach, Page Layout, Available Actions, Related Pages
- Use relative screenshot paths:
../../screenshots/page-guides/{category}/{page}/ - Create screenshot directory:
docs/knowledge-base/screenshots/page-guides/{category}/{page}/ - Add entry to this README index
Screenshot Workflow:
Per established workflow in docs/SCREENSHOT-WORKFLOW.md:
- AI navigates using browser tool
- AI creates screenshots in chat
- User saves screenshots to paths referenced in guides
- Screenshots are placeholders until populated
Summary Statistics
| Category | Guides | Total Lines |
|---|---|---|
| Calendar | 2 | 571 |
| Management | 3 | 786 |
| Communication | 1 | 123 |
| Time & Statistics | 2 | 333 |
| Employee Self-Service | 3 | 310 |
| System | 2 | 387 |
| Settings | 1 | 142 |
| Total | 14 active (17 planned) | 2,652 |
Note: Some guides may be in progress. Check individual files for completion status.
Related Documentation
- User Documentation: ../user/ - Feature-focused documentation
- Developer Documentation: ../developer/ - Technical implementation details
- Architecture: ../developer/architecture/ - System design and API documentation
Last updated: 2026-04-24 | This directory is part of Phase 5: Page Guides