How yuna9068/kanban-task-management works
Project type and purpose
• This is a Vue 3/Nuxt 3 single-page application (SPA) implementing a Kanban board UI.
• There is no separate backend service—data is read/written to localStorage in the browser.
• The app is statically generated or hosted (e.g. GitHub Pages) via a CI/CD workflow.
Major architectural components
a. Hosting & Delivery
– Repository on GitHub
– GitHub Actions workflow (.github/workflows/deploy.yml) for build & deploy
– Static host (e.g. GitHub Pages or any CDN) serving JS/CSS/assets
b. Client (Browser)
– Nuxt 3 “app” shell
– Vue Router (pages/index.vue, pages/about.vue => route components)
– Pinia stores (stores/alert.ts, board.ts, sidebar.ts, task.ts) for global state
– Composables (composables/useDevice.ts) for reusable logic
– UI Components (components/base, components/board, components/task, components/sidebar, components/header)
– 3rd-party libraries: VueUse, VueDraggablePlus, nuxt-svgo, Google Fonts module, ESLint config
c. Persistence
– Browser localStorage for CRUD of boards/tasks/subtasks
d. User Device
– Desktop or mobile browser consuming the SPA
Interactions & Data Flow
• User → Browser UI → Vue components → Pinia store → localStorage (persist)
• On page load: store reads from localStorage → hydrates initial state → UI renders
• Drag-and-drop events (VueDraggablePlus) update store → UI re-orders items → store writes back
• Theme switcher toggles a CSS class on <body> using a composable → persists theme in store/localStorage
Architectural patterns & design principles
• Component-based hierarchy (Base*, Board*, Task*, Sidebar*, Header* folders)
• Directory-based routing (Nuxt pages directory)
• Composables for cross-component logic (device detection, alerts)
• Centralized state with Pinia stores
• SCSS partials and variables for theming and responsive design
• Static generation / SSG approach—no dynamic server API
Technologies & frameworks
• Nuxt 3 (Vue 3, Vue Router 4)
• Pinia 2 for state management
• SCSS for styling (with mixins & variables)
• VueUse for utility composables
• VueDraggablePlus for drag-and-drop
• GitHub Actions for CI/CD
• GitHub Pages / CDN for static hosting