A modern, user-friendly React application for the CS Internship program, built to help applicants and members easily track and manage queue group meeting dates, announcements, and important events, with full Persian (Jalali) and Gregorian calendar support.

Managing weekly queue meetings and announcements can be messy, especially for a large and active program like CS Internship.
CS Queue Calendar solves this by providing:

• A centralized, interactive calendar for queue group meetings.
• Built-in automated announcements for queue admins.
• Seamless Persian/Gregorian date switching for better accessibility.
• One-click Google Calendar integration for desktop users.
• Quick links to all important program resources in one place.

• Interactive Calendar – Navigate events by week with clean UI.
• Persian Calendar Support – Full Jalali date support alongside Gregorian.
• Event Management – Add, edit, and view queue events easily.
• Automated Weekly Announcements – Generate and share pre-formatted meeting announcements.
• Google Calendar Integration (desktop only) – Add events to Google Calendar with all details filled in.
• Quick Access to External Resources – Floating buttons to Telegram, LinkedIn, X (Twitter), Virgool, GitHub, and more.
• Responsive Design – Optimized for desktop and mobile.
• Light/Dark Mode – Custom theming with theme toggle.

Calendar View (Light)	Calendar View (Dark)

• React – Frontend framework
• Ant Design (antd) – UI components
• Sass – Styling
• Day.js & Jalali-Moment – Date handling
• React Toastify – Notifications

1. Clone the repository

   git clone https://github.com/cs-internship/CS-Queue-Calendar.git

2. Install dependencies

   npm install

3. Start the development server

   npm start

4. Build for production

   npm run build

cs-queue-calendar/
│
├── public/                         # Static assets and HTML template
├── src/                            # Application source code
│   ├── App.jsx                     # Main app component
│   ├── index.jsx                   # Entry point
│   ├── assets/
│   │   ├── fonts/                  # Persian fonts (Vazirmatn)
│   │   └── scss/                   # SCSS stylesheets
│   ├── components/
│   │   ├── AnnouncementModule.jsx      # Generate weekly meeting announcements
│   │   ├── CalendarEventCreator.jsx    # Add events to Google Calendar
│   │   ├── CSCalendar.jsx              # Main calendar UI & logic
│   │   ├── FloatButtonSection.jsx      # Theme toggle, announcements, quick links
│   │   ├── Footer.jsx                  # Footer
│   │   ├── Header.jsx                  # Header
│   │   ├── Toastify.jsx                # Toast notifications
│   │   └── useIsMobile.jsx             # Mobile detection hook
│   ├── constants/                      # Static values
│   │   ├── events.js
│   │   ├── persianWeekDays.js
│   │   └── startCalendarDate.js
│   ├── store/
│   │   └── ThemeContext.jsx            # Theme context
│   └── utils/                          # Helper functions
│       ├── convertToPersianNumbers.js
│       ├── createTds.js
│       └── formatPersianDate.js
├── package.json
└── README.md

Admins can select a week and instantly generate a formatted announcement message, ready to post in the queue group. Works for past, current, or future weeks.

Easily add any event to Google Calendar with the exact time, title, notes, and description pre-filled.

Quick floating buttons to:

• Queue group on Telegram
• Telegram feed channel on Telegram
• GitHub organization
• LinkedIn page
• X (Twitter) hashtags
• Virgool blog page

1. Fork the repository on GitHub.
2. Create a new branch for your feature or fix.
3. Follow code style (React, JS, SCSS) and test both light/dark and mobile/desktop views.
4. Write clear commit messages.
5. Test locally before pushing.
6. Open a pull request with a clear description.

This project is licensed under the MIT License.

Author: Ali Sadeghi

Organization: Developed for the CS Internship program