Deadline Buddy AI – Last-Minute Life Saver

Deadline Buddy AI is an AI-powered productivity companion designed to help students manage deadlines, prioritize tasks, generate smart study plans, and avoid last-minute stress.

This project was built for the Vibe2Ship Hackathon under the problem statement “The Last-Minute Life Saver”.

Live Demo

Deployed App: YOUR_DEPLOYED_APP_LINK

Problem Statement

Students often miss deadlines because tasks are scattered, reminders are passive, and planning usually starts too late. Traditional productivity tools mostly remind users about deadlines, but they do not actively help users decide what to do first or how to complete work before time runs out.

Deadline Buddy AI solves this problem by acting as an intelligent productivity companion that helps users plan, prioritize, and complete tasks with AI-powered recommendations.

Solution Overview

Deadline Buddy AI allows students to add academic tasks such as assignments, exams, projects, reports, and revision work. The app analyzes task details like deadline date, time, estimated hours, difficulty, importance, and subtasks.

Using Gemini AI, the app generates:

• Priority scores
• Smart task ranking
• Next best actions
• Study/work timeline blocks
• Personalized reminders
• Productivity insights

The goal is to convert deadline pressure into a clear action plan.

Key Features

1. Smart Task Management

Users can add, edit, complete, delete, and search tasks.

Each task can include:

• Task title
• Description or notes
• Deadline date and time
• Category
• Estimated hours
• Difficulty level
• Importance level
• Reminder preference
• Subtasks checklist

2. Gemini AI Planner

The AI Planner uses Gemini AI to understand the user’s workload and generate a smart action plan.

It provides:

• Global productivity insight
• Task urgency analysis
• Priority score
• AI reason
• Next action
• Smart reminder
• Study plan recommendation

3. Study Timeline

The Study Timeline converts tasks into structured work sessions.

It includes:

• Focus blocks
• Break blocks
• Task-specific planning
• Pomodoro-style study sprints
• Gemini-powered study strategy

4. Priority Matrix

The Priority Matrix organizes tasks using an Eisenhower-style layout:

• Urgent & Important
• Important but Not Urgent
• Urgent but Less Important
• Low Priority

This helps students quickly understand which tasks need immediate attention.

5. Student Profile

The Student Profile page gives a personalized productivity dashboard.

It includes:

• Student profile details
• Profile photo upload
• Goal progress
• Task completion analytics
• Category breakdown
• Difficulty breakdown
• Achievement badges
• Gemini productivity insight

Profile and task data are stored locally in the browser.

6. Progress Analytics

The app includes visual progress tracking such as:

• Overall task progress
• Completed tasks
• Active tasks
• Total hours
• Productivity score
• Goal progress
• Task status overview

7. Judge Demo Mode

The app includes a Load Demo Tasks feature so judges can quickly test the complete workflow without manually adding tasks.

Demo flow:

1. Load demo tasks
2. Generate Gemini AI plan
3. Review timeline
4. Check priority matrix
5. View student profile analytics

8. Dark and Light Mode

Deadline Buddy AI supports both dark mode and light mode with a modern responsive interface.

9. Responsive Design

The app is designed to work across:

• Desktop
• Tablet
• Mobile

A responsive navbar and mobile-friendly layout make the app easy to use on different screen sizes.

Google Technologies Used

• Google AI Studio – Used as the core tool to build and deploy the application.
• Gemini API – Used to generate AI-powered productivity plans, task prioritization, smart reminders, and study timelines.
• Google Cloud Run Deployment through AI Studio – Used for public deployment.

Tech Stack

• React
• TypeScript
• Vite
• Node.js server
• Gemini API
• localStorage
• CSS animations
• Responsive UI design

Project Structure

deadline-buddy-ai/
├── assets/
├── src/
│   ├── components/
│   │   ├── AboutTab.tsx
│   │   ├── DashboardTab.tsx
│   │   ├── Footer.tsx
│   │   ├── MatrixTab.tsx
│   │   ├── PlannerTab.tsx
│   │   ├── ProfileTab.tsx
│   │   └── TimelineTab.tsx
│   ├── App.tsx
│   ├── index.css
│   ├── main.tsx
│   └── types.ts
├── .env.example
├── .gitignore
├── index.html
├── package.json
├── server.ts
├── tsconfig.json
├── vite.config.ts
└── README.md

Installation and Setup

1. Clone the repository

git clone https://github.com/PritKoradiya/deadline-buddy-ai.git

2. Open project folder

cd deadline-buddy-ai

3. Install dependencies

npm install

4. Create environment file

Create a .env file in the root folder:

GEMINI_API_KEY=your_gemini_api_key_here
APP_URL=http://localhost:3000

Do not upload the .env file to GitHub.

5. Run the project locally

npm run dev

Open:

http://localhost:3000

Environment Variables

The project uses the following environment variables:

GEMINI_API_KEY=your_gemini_api_key_here
APP_URL=your_app_url_here

A sample file is included as:

.env.example

Data Storage

Deadline Buddy AI stores task and profile data in the user’s browser using localStorage.

This means:

• Data remains after refresh.
• Data is stored locally in the same browser.
• No database is required.
• The Gemini API is used only when the user generates an AI plan.

AI Safety and Fallback

If Gemini AI is unavailable or the API request fails, the app uses a local fallback priority system. This ensures the app remains usable even when the AI service is temporarily unavailable.

Why This Project Matters

Deadline Buddy AI does more than remind users about deadlines. It helps users take meaningful action by showing what to do first, why it matters, and how to complete the work through structured planning.

It supports the hackathon goal by demonstrating how AI can improve productivity, decision-making, and task completion.

Future Scope

Possible future improvements:

• Google Calendar integration
• Firebase Auth for user accounts
• Firestore for cloud task sync
• Google Analytics for real usage tracking
• Voice-based task creation
• Email or push reminders
• Team collaboration workspace

Author

Pritkumar Koradiya

Hackathon

Built for Vibe2Ship Hackathon Problem Statement: The Last-Minute Life Saver

License

This project is created for hackathon and learning purposes.