Skip to content

croine/9td-desktop-app-project

Repository files navigation

๐ŸŽฏ 9TD Task Dashboard

9TD Logo Next.js TypeScript Tailwind

A beautiful, professional-grade task management desktop application with 3D animations

Features โ€ข Quick Start โ€ข Documentation โ€ข Screenshots


โœจ Features

๐ŸŽจ Stunning UI/UX

  • 3D Animated Title: Eye-catching rotating 9TD logo with gradient effects
  • Bright Professional Theme: Cozy, modern design with perfect color harmony
  • Smooth Animations: Framer Motion powered transitions and micro-interactions
  • Responsive Layout: Desktop-optimized with sidebar navigation

๐Ÿ“‹ Advanced Task Management

  • Create, edit, and delete tasks with rich metadata
  • Priority levels: Low, Medium, High, Urgent
  • Status tracking: Todo, In Progress, Review, Completed, Cancelled
  • Due date management with overdue alerts
  • Multi-user assignee support
  • Detailed descriptions and notes

๐Ÿท๏ธ Smart Organization

  • Tags: Flexible labeling with custom colors (#Bug, #Feature, etc.)
  • Categories: Hierarchical organization with emoji icons (๐Ÿ’ป Development, ๐ŸŽจ Design)
  • Color-coded System: Visual identification at a glance
  • Unlimited Combinations: Mix and match tags/categories per task

๐Ÿ” Powerful Search & Filtering

  • Real-time text search across titles and descriptions
  • Multi-criteria filtering (priority, status, tags, categories)
  • Visual filter chips with one-click removal
  • Instant results with no lag

๐Ÿ“Š Analytics Dashboard

  • Task completion rate with progress bars
  • Priority breakdown visualization
  • Upcoming deadlines calendar view
  • Category and tag usage statistics
  • System health monitoring

๐Ÿ“ Activity Logging

  • Complete audit trail of all operations
  • Action types: Created, Updated, Deleted, Status Changed
  • Timestamp tracking with relative time display
  • Automatic log retention (last 500 entries)

๐ŸŽ›๏ธ Owner Panel

  • Tag management with color customization
  • Category management with icon selection
  • 16 preset colors + custom color picker
  • Real-time analytics and storage metrics

โš™๏ธ Settings & Preferences

  • Theme selection (Light/Dark/System)
  • View modes (Grid/List)
  • Compact mode for dense displays
  • Notification toggles
  • Data export (JSON backup)
  • Clear all data option

๐Ÿ’พ Local Storage Persistence

  • All data stored in browser LocalStorage
  • No server required - runs completely offline
  • Automatic save on every action
  • Export/import capabilities

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+ or Bun
  • Modern web browser (Chrome, Firefox, Safari, Edge)

Installation

# Clone or download the project
cd your-project-directory

# Install dependencies
npm install
# or
bun install

Development

# Start development server
npm run dev
# or
bun dev

# Open http://localhost:3000 in your browser

Production Build

# Build for production
npm run build

# Start production server
npm start

๐Ÿ“– Usage

Getting Started

  1. Launch the app - Open http://localhost:3000
  2. Explore the Dashboard - View your task overview and statistics
  3. Create your first task - Click "Create Task" or use the sidebar
  4. Organize - Add tags and categories to your tasks
  5. Filter & Search - Use the search bar to find specific tasks
  6. Track Progress - Update task statuses as you work

Key Actions

Action How To
Create Task Sidebar โ†’ Create Task โ†’ Fill form โ†’ Create
Edit Task Your Tasks โ†’ Click โ‹ฎ โ†’ Edit Task
Delete Task Your Tasks โ†’ Click โ‹ฎ โ†’ Delete Task
Filter Tasks Your Tasks โ†’ Filters button โ†’ Select criteria
Manage Tags Owner Panel โ†’ Tags tab โ†’ Add/Edit/Delete
View Analytics Dashboard or Owner Panel โ†’ Analytics tab
Export Data Settings โ†’ Data Management โ†’ Export All Data

๐ŸŽจ Screenshots

Dashboard View

Beautiful analytics with task statistics, completion rates, and upcoming deadlines.

Task Management

Grid layout with colorful cards showing priority, status, tags, and categories.

Owner Panel

Comprehensive tag and category management with visual customization.

Activity Logs

Complete audit trail with timestamps and action types.


๐Ÿ—๏ธ Tech Stack

  • Framework: Next.js 15 (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS v4
  • UI Components: Shadcn/UI + Radix UI
  • Animations: Framer Motion
  • Date Handling: date-fns
  • Notifications: Sonner (Toast)
  • Storage: Browser LocalStorage API

๐Ÿ“ Project Structure

src/
โ”œโ”€โ”€ app/
โ”‚   โ”œโ”€โ”€ page.tsx              # Main app component
โ”‚   โ”œโ”€โ”€ layout.tsx            # Root layout
โ”‚   โ””โ”€โ”€ globals.css           # Global styles & theme
โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ AnimatedTitle.tsx     # 3D animated header
โ”‚   โ”œโ”€โ”€ Sidebar.tsx           # Navigation sidebar
โ”‚   โ”œโ”€โ”€ Dashboard.tsx         # Analytics dashboard
โ”‚   โ”œโ”€โ”€ TaskCard.tsx          # Individual task
โ”‚   โ”œโ”€โ”€ TaskList.tsx          # Task grid/list
โ”‚   โ”œโ”€โ”€ CreateTaskModal.tsx   # Task form modal
โ”‚   โ”œโ”€โ”€ SearchBar.tsx         # Search & filters
โ”‚   โ”œโ”€โ”€ ActivityLog.tsx       # Activity logs
โ”‚   โ”œโ”€โ”€ OwnerPanel.tsx        # Tag/category mgmt
โ”‚   โ”œโ”€โ”€ Settings.tsx          # App settings
โ”‚   โ””โ”€โ”€ ui/                   # Shadcn components
โ”œโ”€โ”€ types/
โ”‚   โ””โ”€โ”€ task.ts               # TypeScript types
โ””โ”€โ”€ lib/
    โ””โ”€โ”€ storage.ts            # LocalStorage API

๐Ÿ”ง Configuration

Default Tags (6 pre-configured)

  • ๐Ÿ› Bug (Red)
  • โœจ Feature (Blue)
  • ๐Ÿš€ Enhancement (Purple)
  • ๐Ÿ“š Documentation (Teal)
  • โš ๏ธ Urgent (Orange)
  • ๐ŸŽจ Design (Pink)

Default Categories (6 pre-configured)

  • ๐Ÿ’ป Development (Blue)
  • ๐ŸŽจ Design (Pink)
  • ๐Ÿ“ข Marketing (Teal)
  • ๐Ÿ’ฐ Sales (Orange)
  • ๐Ÿ›Ÿ Support (Purple)
  • ๐Ÿ”ฌ Research (Cyan)

๐Ÿ’พ Data Storage

All data is stored locally in your browser using LocalStorage:

  • Tasks: ntd_tasks
  • Tags: ntd_tags
  • Categories: ntd_categories
  • Activity Logs: ntd_logs
  • Settings: ntd_settings

Storage Capacity: ~5-10MB (varies by browser) Estimated Capacity: 2,500-5,000 tasks


๐Ÿ“š Documentation

For comprehensive documentation including:

  • Detailed architecture explanation
  • Complete API reference
  • LocalStorage data schemas
  • User guide and tutorials
  • Troubleshooting tips

See DOCUMENTATION.md


๐ŸŽฏ Features Checklist

  • โœ… Advanced task management (CRUD operations)
  • โœ… Priority and status tracking
  • โœ… Tags and categories with colors
  • โœ… Due date management
  • โœ… Search and advanced filtering
  • โœ… Real-time dashboard analytics
  • โœ… Activity logging system
  • โœ… Owner panel for customization
  • โœ… Settings and preferences
  • โœ… LocalStorage persistence
  • โœ… Data export/import
  • โœ… 3D animated title
  • โœ… Bright professional UI theme
  • โœ… Toast notifications
  • โœ… Responsive design
  • โœ… Comprehensive documentation

๐Ÿ› Troubleshooting

Tasks not saving?

  • Ensure LocalStorage is enabled in browser settings
  • Check browser storage quota hasn't been exceeded

UI not updating?

  • Hard refresh: Ctrl/Cmd + Shift + R
  • Clear browser cache

Performance issues?

  • Enable compact mode in Settings
  • Archive or delete old completed tasks
  • Check browser console for errors

๐Ÿค Contributing

This is a demonstration project showcasing modern web development practices with Next.js, TypeScript, and Shadcn/UI.


๐Ÿ“„ License

This project is provided as-is for demonstration purposes.


๐ŸŒŸ Highlights

  • Zero Configuration: Works out of the box
  • No Backend Required: Fully client-side
  • Privacy First: All data stays in your browser
  • Fast: Instant operations with no network delay
  • Beautiful: Modern, professional design
  • Powerful: Enterprise-grade features

Built with โค๏ธ using Next.js, TypeScript, and Shadcn/UI

๐Ÿ“– Read Full Documentation | ๐Ÿ› Report Issues | โœจ Request Features

About

Project from Orchids.app - 9td-desktop-app-project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages