SmartDesk for Hack for Good 2025

Description

This web application serves as a cost-effective digital personal assistant (PA) for administrators to efficiently arrange and schedule meetings, automate follow-up tasks, send reminders, and manage their workflow. Built using modern web technologies, the app simplifies administrative tasks, boosts productivity, and reduces manual effort.

Features

• Login/Logout: Secure authentication for users.
• Meetings Management: Schedule, update, and view meetings efficiently.
• (Upcoming) Task Management: Assign and track follow-up tasks for yourself or others.
• Reminders: Automated timers to send reminders for scheduled meetings and tasks.
• (Upcoming) Email Summarization: Generate summaries of email threads (currently under development).

How it solves the problem statement

• The reminder feature reduces manual tracking by automating notifications.
• The login system ensures secure access to the application.
• The upcoming task management system simplifies follow-up tasks and ensures timely completion.
• The meetings management system streamlines the scheduling process and ensures efficient time management.
• The upcoming email summarization feature will save administrators time by condensing lengthy email threads into concise summaries.
• The application is cost-effective and easy to use, making it accessible to a wide range of users.

Technologies Used

Frontend

• React: For building user interfaces.
• TypeScript: For type-safe JavaScript development.
• Vite: A fast and efficient development build tool.

Backend

• Node.js: For server-side operations.
• Firebase: For authentication, database, and cloud functions.

Installation

Follow these steps to set up the project locally using your terminal:

1. Clone the Repository:

   git clone https://github.com/hack-for-good-2025/h4g2025
   cd h4g2025

2. Install Dependencies

    # Install frontend dependencies
    cd frontend
    npm install
   
    # Install backend dependencies and go back to the root directory
    cd ../backend
    npm install
    cd ..

3. Run the application

    # Run the frontend dev server
    cd frontend
    npm run start
   
    # Run the backend dev server
    cd ../backend
    npm run dev

4. Access the application at http://localhost:5173/.

Usage

1. Login/Logout:

   • Use the login form to sign in to the application.
   • Click on the logout button to sign out of the application.

2. Meetings Management:

3. Task Management:

4. Reminders:

Project Structure

The project is divided into two main directories: frontend and backend.

Contributing

We welcome contributions from the community. To contribute to the project, follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Commit your changes and push them to your fork.
4. Submit a pull request describing your changes.