An open API service indexing awesome lists of open source software.

https://github.com/aymansoliman-dev/calenda

Calenda is a clean, responsive, and intuitive task management app designed for individuals and teams who value clarity, speed, and control. This Beta version, crafted for a competition, lays the foundation for a powerful, full-featured productivity platform.
https://github.com/aymansoliman-dev/calenda

crud-application dom-manipulation eventlisteners flexbox grid localstorage oop-principles responsive-layout task-manager vanilla-javascript

Last synced: about 1 year ago
JSON representation

Calenda is a clean, responsive, and intuitive task management app designed for individuals and teams who value clarity, speed, and control. This Beta version, crafted for a competition, lays the foundation for a powerful, full-featured productivity platform.

Awesome Lists containing this project

README

          

# ๐Ÿง  Calenda | Beta Version

**A bold step toward redefining productivity.**

**Calenda** is a clean, responsive, and intuitive **task management app** designed for individuals and teams who value **clarity, speed, and control**. This **Beta version**, crafted for a competition, lays the foundation for a powerful, full-featured productivity platform.

---

## ๐Ÿ“š Table of Contents

- [๐Ÿš€ Vision](#-vision)
- [โš™๏ธ Tech Stack](#-tech-stack)
- [โœจ Features (Beta)](#-features-beta)
- [๐Ÿ“ฆ Upcoming Features](#-upcoming-features)
- [๐Ÿ”— Links](#-links)
- [๐Ÿงช Beta Usage](#-beta-usage)
- [๐Ÿ›  Installation (for Developers)](#-installation-for-developers)
- [๐Ÿ”จ Development Process](#-development-process)
- [๐Ÿ”ง Built With](#-built-with)
- [๐Ÿง  AI Assistance](#-ai-assistance)
- [๐Ÿงฑ Folder Structure](#-folder-structure)
- [๐Ÿ‘จโ€๐Ÿ’ป Author](#-author)
- [๐Ÿ“Œ Project Status](#-project-status)

---

## ๐Ÿš€ Vision

Calenda aims to deliver a **fully functional, beautifully designed task management platform** that balances simplicity with powerful functionality. The beta version establishes core features, setting the stage for a full product with persistent storage, user authentication, and real-time collaboration.

Our mission is to empower users with a tool that streamlines task management, fosters productivity, and adapts seamlessly to individual and team workflows.

---

## โš™๏ธ Tech Stack

- **HTML5**: Semantic, accessible markup
- **CSS3**: Modular styles with custom properties
- **JavaScript (Vanilla)**: Lightweight, class-based logic with OOP principles
- **Material UI Icons**: Polished, lightweight icons via CDN
- **LocalStorage**: Task persistence in the browser
- **OOP Principles**: Modular, maintainable codebase

---

## โœจ Features (Beta)

- โœ… **Task Management**: Add, delete, and manage tasks effortlessly
- ๐Ÿ“Œ **Task Prioritization**: Organize tasks by priority
- ๐Ÿ”„ **Drag & Drop**: Intuitive task reordering across columns
- ๐ŸŒ“ **Dark Mode**: Toggle between light and dark themes
- ๐Ÿ“ฑ **Mobile Support**: Responsive design with column switching
- ๐Ÿ’พ **LocalStorage**: Persistent task storage in the browser

---

## ๐Ÿ“ฆ Upcoming Features

- ๐Ÿ”— **Backend Integration**: REST API support via Axios for data syncing
- ๐Ÿ‘ค **User Authentication**: Secure login and user management
- โฐ **Due Dates & Notifications**: Timely reminders for tasks
- ๐Ÿ” **Undo/Redo History**: Enhanced user control over actions
- ๐Ÿงช **Session Storage Demo Mode**: Try Calenda without saving data
- ๐Ÿ“Š **Admin Dashboard**: Team management and analytics
- ๐Ÿš€ **Progressive Web App (PWA)**: Offline access and mobile app-like experience

---

## ๐Ÿ”— Links

- ๐Ÿง  **Solution URL**: [GitHub Repository](https://github.com/aymansoliman-dev/Calenda)
- ๐ŸŒ **Live Site**: [Live Preview](https://aymansoliman-dev.github.io/Calenda/)

---

## ๐Ÿงช Beta Usage

To try Calenda's beta version:

1. Visit the [Live Preview](https://aymansoliman-dev.github.io/Calenda/)
2. Create, manage, and prioritize tasks
3. Drag tasks between columns for a seamless organization
4. Toggle dark mode for a comfortable viewing experience
5. Enjoy responsive design on mobile devices with task persistence via `LocalStorage`

---

## ๐Ÿ›  Installation (for Developers)

To set up Calenda locally:

```bash
git clone https://github.com/aymansoliman-dev/Calenda
cd Calenda
```

Open `index.html` in a browser to run the app locally. No additional dependencies are required.

---

## ๐Ÿ”จ Development Process

Calenda was designed with a focus on clean architecture, mobile-first responsiveness, and performance. The project adheres to competition constraints while leveraging OOP principles for scalability and maintainability.

### ๐Ÿ”ง Built With

- **Semantic HTML5**: Accessible, structured markup
- **CSS Custom Properties**: Modular, reusable styles
- **Desktop-First Workflow**: Optimized for all screen sizes
- **Flexbox & Grid**: Modern, responsive layouts
- **Material Icons**: Lightweight, professional icons via CDN
- **Vanilla JavaScript**: Class-based, modular code with animations
- **Hover Transitions**: Smooth, engaging UI interactions

---

## ๐Ÿง  AI Assistance

This project was enhanced with OpenAI's ChatGPT as a collaborative tool for:

- ๐Ÿง  Architectural brainstorming and planning
- โœ๏ธ Writing and refining this README
- ๐Ÿงฉ Debugging JavaScript logic and DOM issues

AI served as a thinking partner, with all code and design decisions handcrafted for precision and ownership.

---

## ๐Ÿงฑ Folder Structure

```
โ”œโ”€โ”€ index.html
โ”‚
โ”œโ”€โ”€ shared/
โ”‚ โ”œโ”€โ”€ stylesheets/
โ”‚ โ”‚ โ”œโ”€โ”€ panel.css
โ”‚ โ”‚ โ”œโ”€โ”€ task-popup.css
โ”‚ โ”‚ โ”œโ”€โ”€ icons.css
โ”‚ โ”‚ โ”œโ”€โ”€ responsive-un pitiful.css
โ”‚ โ”‚ โ””โ”€โ”€ colors-palette.css
โ”‚ โ”‚
โ”‚ โ””โ”€โ”€ objects/
โ”‚ โ”œโ”€โ”€ Task.js
โ”‚ โ”œโ”€โ”€ DarkThemeToggleListener.js
โ”‚ โ””โ”€โ”€ MobileTabsHandler.js
โ”‚
โ”œโ”€โ”€ beta/
โ”‚ โ”œโ”€โ”€ beta.html
โ”‚ โ”œโ”€โ”€ beta.js
โ”‚ โ”œโ”€โ”€ BetaDragAndDropListener.js
โ”‚ โ”œโ”€โ”€ BetaTaskColumnAddButtonListener.js
โ”‚ โ””โ”€โ”€ BetaTaskCreator.js
โ”‚
โ”œโ”€โ”€ app/
โ”‚ โ”œโ”€โ”€ app.html
โ”‚ โ”œโ”€โ”€ app.js
โ”‚ โ”œโ”€โ”€ AppDragAndDropListener.js
โ”‚ โ”œโ”€โ”€ AppTaskColumnAddButtonListener.js
โ”‚ โ”œโ”€โ”€ AppTaskCreator.js
โ”‚ โ””โ”€โ”€ NotificationsSystem.js
โ”‚
โ””โ”€โ”€ landing-page/
โ”œโ”€โ”€ landing-page.html
โ”œโ”€โ”€ login.html
โ”œโ”€โ”€ signup.html
โ””โ”€โ”€ main.js
```

---

## ๐Ÿ‘จโ€๐Ÿ’ป Author

**Ayman Soliman**
Frontend Developer

- Website - [Ayman Soliman](https://bento.me/ayman-soliman)
- Frontend Mentor - [aymansoliman-dev](https://www.frontendmentor.io/profile/aymansoliman-dev)
- Twitter - [@a_soliman1783](https://x.com/a_soliman1783)

*"Calenda began as a competition entry and is evolving into a fully capable productivity platform."*

---

## ๐Ÿ“Œ Project Status

- โœ… **Beta Complete**: Core features implemented and live
- ๐Ÿšง **Full App in Development**: Backend, authentication, and PWA in progress
- ๐Ÿ›  **Next Steps**: Backend integration, PWA support, and enhanced features

---