Skip to content

SiwarGamdou/TODO

Repository files navigation

✨ My Tasks - Aesthetic TODO App

A beautiful, minimal TODO application with soft pastel blue colors designed for a calming and focused task management experience.

🎨 Features

✅ Core Functionality

  • Add Tasks: Create new tasks with an intuitive input field
  • Mark Complete: Check off completed tasks with satisfying animations
  • Delete Tasks: Remove tasks with a clean delete action
  • Filter Views: Switch between All, Active, and Completed tasks
  • Task Counter: View remaining active tasks at a glance

🎭 Design Highlights

  • Soft Pastel Blue Theme: Calming color palette for stress-free productivity
  • Glowing Input Effects: Beautiful focus states that guide user attention
  • Floating Action Button: Quick access to add tasks from anywhere
  • Smooth Animations: Elegant transitions and hover effects throughout
  • Responsive Design: Perfect on desktop, tablet, and mobile devices
  • Clean Typography: Inter font for excellent readability

💫 User Experience

  • Empty States: Helpful messages when no tasks exist in each filter
  • Visual Feedback: Clear indicators for task completion status
  • Hover Interactions: Subtle animations that enhance usability
  • Keyboard Support: Add tasks by pressing Enter
  • Statistics Display: Track progress with task counters

🛠️ Tech Stack

  • Frontend: React 18 + TypeScript
  • Styling: Tailwind CSS 3 with custom pastel blue theme
  • Icons: Lucide React
  • Build Tool: Vite
  • Backend: Express.js (ready for API integration)
  • Deployment: Netlify-ready configuration

🚀 Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository

    git clone <your-repo-url>
    cd fusion-starter
  2. Install dependencies

    npm install
  3. Start development server

    npm run dev
  4. Open your browser

    • Navigate to http://localhost:8080
    • Start managing your tasks! ✨

📁 Project Structure

client/
├── pages/
│   └── Index.tsx          # Main TODO app component
├── lib/
│   └── todo-types.ts      # TypeScript types and utilities
├── components/ui/         # Reusable UI components
├── global.css            # Tailwind + custom pastel theme
└── App.tsx               # App router and layout

server/
├── index.ts              # Express server setup
└── routes/               # API endpoints (ready for expansion)

shared/
└── api.ts                # Shared TypeScript interfaces

🎨 Color Theme

The app uses a carefully crafted pastel blue color palette:

  • Primary: Soft pastel blue variations
  • Background: Light blue gradient with white accents
  • Text: Clean dark grays for optimal readability
  • Accents: Subtle blue tones for interactive elements

📱 Responsive Design

  • Mobile First: Optimized for mobile devices
  • Tablet Ready: Perfect layout on iPad and similar devices
  • Desktop Enhanced: Takes advantage of larger screens
  • Touch Friendly: Large tap targets for mobile interaction

🚀 Deployment

Netlify (Recommended)

  1. Connect your repository to Netlify
  2. Build command: npm run build
  3. Publish directory: dist/spa
  4. Deploy! 🎉

Manual Deployment

npm run build
npm start

🔧 Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run start - Start production server
  • npm test - Run tests
  • npm run typecheck - TypeScript validation

🎯 Future Enhancements

  • Due Dates: Add deadline tracking
  • Categories: Organize tasks by project or context
  • Dark Mode: Toggle between light and dark themes
  • Cloud Sync: Save tasks across devices
  • Drag & Drop: Reorder tasks by priority
  • Subtasks: Break down complex tasks

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

  • Design inspired by modern minimal interfaces
  • Built with love using React and Tailwind CSS
  • Icons provided by Lucide React

Made with ❤️ for productive and peaceful task management

About

Created with Builder.io

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages