Smart Task Planner bridges the gap between vision and execution. It leverages Google's advanced Gemini API to analyze a user's high-level goal and intelligently generate a comprehensive roadmap. The result is a detailed list of tasks, complete with descriptions, time estimates, and dependencies, giving users a clear and actionable path to success.
This project was built to demonstrate a modern, secure, and performant full-stack application using a serverless backend architecture, ensuring both a great user experience and robust security.
This application integrates several key technical features to deliver a seamless and powerful planning experience.
### AI-Powered Plan Generation
-**Logic**: The core of the application resides in the `/api/generate-plan.ts` Vercel Edge Function. When a user submits a goal, the frontend sends a request to this secure backend endpoint. The function then constructs a detailed prompt, instructing the Gemini AI to act as an expert project manager.
-**Structured Output**: To ensure a reliable and predictable response from the AI, the backend enforces a strict JSON schema via the `responseSchema` configuration. This forces the Gemini model to return a perfectly formatted JSON array of tasks, which the frontend can parse and render without requiring complex data manipulation.
### Dynamic Task Dependency System
-**Logic**: The AI generates a `dependencies` array for each task (e.g., `["task-1", "task-3"]`). On the frontend, the `TaskList` component maintains a `Set` of completed task IDs for efficient lookups.
-**User Experience**: Before rendering each task, the application checks if all of its prerequisite tasks have been completed. A task is visually "locked" (greyed out and non-interactive) if any of its dependencies are not yet met. Once all dependencies are finished, the task automatically unlocks, creating an intuitive and logical workflow for the user.
### Interactive Progress Tracking
-**Logic**: The `PlannerView` component uses React's `useMemo` hook to efficiently calculate progress metrics whenever the `tasks` array changes. It counts completed tasks versus the total and sums the `durationInHours` for all tasks to provide a total project estimate.
-**User Experience**: Users get immediate visual feedback via a dynamic progress bar, a "X / Y Tasks" counter, and a total estimated project duration, keeping them motivated and informed.
### Secure Serverless Architecture
-**Logic**: The frontend **never** communicates directly with the Gemini API. All API calls are proxied through the `/api/generate-plan` serverless function. The `API_KEY` is stored securely as an environment variable on Vercel's servers and is never exposed to the client's browser. This is a critical security best practice that prevents key leakage.
### Simulated Authentication Flow
-**Logic**: The application uses React state to manage a `currentUser` object, simulating a complete login/signup flow. Views are conditionally rendered based on whether a user object exists in the state, protecting the main planner view from unauthenticated access. This demonstrates state management for a typical user-gated application.
---
## Tech Stack
This project is built with a modern web development stack:
-**Frontend:**
-**React**: For building the component-based user interface.
-**TypeScript**: For static typing, improved code quality, and developer experience.
-**Tailwind CSS**: For rapid, utility-first styling and a responsive design.
-**Backend (Serverless):**
-**Vercel Edge Functions**: To create a secure, scalable backend proxy for API calls.
-**Core API:**
-**Google Gemini API**: The AI engine for intelligent plan generation.
-**Deployment:**
-**Vercel**: For seamless, Git-based deployment and hosting.
---
## Local Development Setup
To get a local copy up and running, follow these steps.
### Prerequisites
- Node.js (v18 or later recommended)
- npm, yarn, or pnpm
- A Google Gemini API Key. You can get one for free from [Google AI Studio](https://makersuite.google.com/).
Create a new file named `.env` in the root of your project and add your Gemini API key:
```
API_KEY="YOUR_GEMINI_API_KEY_HERE"
```
4. **Run the development server:**
Use the Vercel CLI to run the project. This is the best method as it correctly serves both the React frontend and the serverless function in the `/api` directory.
```sh
vercel dev
```
Your application should now be running at `http://localhost:3000`.
---
## Deployment
This application is optimized for deployment on [Vercel](https://vercel.com/).
1. Push your code to a Git repository (GitHub, GitLab, etc.).
2. Import the repository into Vercel.
3. **Configure the Environment Variable (Crucial Step):**
- In your Vercel project settings, navigate to **Settings > Environment Variables**.
- Add a variable with the name `API_KEY` and paste your Gemini API key as the value.
4. Deploy. Vercel will automatically handle the build process for both the frontend and the serverless function.