Skip to content

Latest commit

 

History

History

task-manager

README.md

Task Manager

A task management app showcasing Meteor-RPC for type-safe methods and publications, shadcn/ui components, and Tailwind CSS. Full CRUD with real-time reactivity, status and priority filters, and a live dashboard.

Demo: https://task-manager.sandbox.galaxycloud.app/

Stack

Runtime Meteor 3.6
Frontend React 19 + TypeScript
UI shadcn/ui (Radix + Tailwind)
Styling Tailwind CSS 4
Data Meteor-RPC + React Query
Validation Zod
Tests Mocha
Code Quality Biome
E2E Playwright
Build Rspack

Features

  • Create, edit, and delete tasks
  • Status management (To Do, In Progress, Done) with one-click cycling
  • Priority levels (Low, Medium, High)
  • Filter tasks by status and priority
  • Real-time dashboard with task metrics

Running it

meteor npm install
npm start

Visit http://localhost:3000/.

Command What it does
npm start Start the app
npm test Integration tests (Mocha, watch mode)
npm run test:headless Integration tests (Mocha, headless/CI)
npm run lint Lint and check formatting (Biome)
npm run lint:fix Lint and auto-fix + format (Biome)
npm run e2e E2E tests (Playwright, interactive UI)
npm run e2e:headless E2E tests (Playwright, headless)

Before running E2E tests for the first time, install Playwright's browsers with npx playwright install.

How it's structured

imports/
  api/
    tasks.ts        # Typed collection and Meteor-RPC module (exports the TaskApi type)
    taskSchema.ts   # Shared Zod schemas and Task model
    client.ts       # Client API (createClient)
  lib/
    utils.ts        # cn() utility for Tailwind class merging
  ui/
    App.tsx         # Main app layout
    Dashboard.tsx   # Reactive metrics cards
    TaskList.tsx    # Task table with filters and actions
    TaskForm.tsx    # Create/edit dialog
    components/ui/  # shadcn/ui components
client/
  main.tsx          # Entry point with QueryClientProvider
  main.css          # Tailwind + shadcn/ui CSS variables
server/
  main.ts           # Server entry (imports API module)

shadcn/ui setup notes

Since shadcn/ui doesn't officially support Meteor, components are manually installed:

  1. Radix UI primitives are installed as npm dependencies
  2. Component source files are copied into imports/ui/components/ui/
  3. The cn() utility uses clsx + tailwind-merge
  4. Tailwind is configured with CSS custom properties for theming
  5. Path alias @ maps to imports/ via Rspack config

TypeScript

Run meteor npm run typecheck after installing dependencies. It runs meteor types to regenerate the Meteor 3.6 package declarations in .meteor/types, then tsc --noEmit. The generated files stay out of Git. Run meteor npm run types after changing Meteor packages to refresh editor types. The configuration uses native declarations without @types/meteor or zodern:types.

The collection model is inferred from the shared Zod schemas, and the client uses createClient<TaskApi>() with a type-only import of the server API. UI props and method inputs are checked without bundling the server registration on the client.

Meteor-RPC 1.1 uses Zod 3 and publishes TypeScript source. The patch in patches/ is applied by postinstall to align publication resolver and optional argument types, native Meteor call results, and React 19's reducer types. It also passes a single cursor to the shared publication hook, as required by useFind.

Deployment

  • Galaxy: meteor deploy your-app.meteorapp.com
    • To try it quickly with a free tier and shared MongoDB: meteor deploy your-app.meteorapp.com --free --mongo
  • Any Node.js host: meteor build gives you a standard Node bundle
  • MUP: automated deploy to your own server over SSH

Links