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/
| 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 |
- 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
meteor npm install
npm startVisit 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.
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)
Since shadcn/ui doesn't officially support Meteor, components are manually installed:
- Radix UI primitives are installed as npm dependencies
- Component source files are copied into
imports/ui/components/ui/ - The
cn()utility usesclsx+tailwind-merge - Tailwind is configured with CSS custom properties for theming
- Path alias
@maps toimports/via Rspack config
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.
- 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
- To try it quickly with a free tier and shared MongoDB:
- Any Node.js host:
meteor buildgives you a standard Node bundle - MUP: automated deploy to your own server over SSH