A simple calendar program to stay organized
Explore the docs »
View Demo
·
Report Bug
·
Request Feature
This project was created as part of my Sophomore Comp Sci II course. I wanted a minimal program to keep myself organized and on top of all of my tasks.
I really wanted to create a program that I could benefit from personally and potentially use in my day-to-day life.
Of course, there are plenty of other calendar programs that exists and work perfectly fine. So, why reinvent the wheel?
Well, I thought it would be a fun challenge to build a utility-type program that seems simple at first but in actuallity has a plethora of intricate and complex parts.
The main features of this program are the month-to-month grid view displaying the current day, as well as any upcoming or previous events.
Users have the ability to add and edit events and click through the year to view or add any events in the upcoming months.
That's pretty much it.
This project was mostly a demonstration of my knowledge and understanding of Programming Fundamentals and the Java Language.
Fig.1 - Launch Screen
Fig.2 - Home Screen
Fig.3 - A view of the events window
This is the first full program I wrote from scratch.
The main 2 challenges I ran into was (1) figuring out how to arrange the days in the correct order of the month and (2) changing the display when moving between months.
To solve the first issue, I used the DATE class to grab the current ISO date and using an algorithm was able to extract the day of the week.
Looking back at this, I could have used Java's built-in date formatter to extract the String form of the current Date. This would increase the program's effeciancy and load speeds.
As for the second issue, I opted to keep the same rendered display and simply change the text values of the days and the shades of the elements belonging to the current month.
The issue with this was the number of UI elements that needed to be updated each time the user changed months. Granted, it was a lot more effecient than reloading the same elements but with different values,
But this also meant needing to write 7 different case statements depending on what day of the week the 1st day of the month fell on (which dictates where the rest of the days fall on- very useful).
What this looks like is around 700 lines of code changing each element individually. I struggled with finding a data structure that could hold JavaFX elements and iterate through them as well, but my knowledge was
quite limited at the time. With the knowledge I have today, I would create my own iteratable data structure for JavaFX elements and save a couple hundred lines of code and hours of my time.
Overall, I am content with the amount of progress made in this project in the two weeks of working on it.
Who knows... maybe I'll come back and add on more to this
- ✅ Display current day & month as well as next/prev months
- ✅ Add, edit, or remove custom events
- Add the ability to color-code events
- ✅ Events saved and loaded locally
Lots of online tutorials and many references to the class slides. No other external sources or libraries were used.
Distributed under the MIT License. See LICENSE.txt for more information.
Walid Harkous- @github - harkouswalid@gmail.com
Project Link: Calendar
- Special thanks to Professor Russel Adam for providing the necessary resources to bring this project to life
- Big shout out to my OG Advisor Charles Wiseman for the guidance before the beginning of this course
At the time of writing this, this project is no longer being maintained. It was a great learning opportunity. If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request