Skip to content

trellix

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

trellix

README.md

Trellix - Task and Project Manager

A Trello-style task and project management app powered by the Base44 backend.

🔗 View Live Demo

Get started

Note: Node.js v20.19.0 or higher and a Base44 account are required.

  1. Install the Base44 CLI globally.

    npm install -g base44

  2. From the repo root, go to the app and install its dependencies.

    cd trellix
npm install

  3. Log in and link the project.

    base44 login
base44 link

    This links your local project to a new or existing Base44 project. The command creates base44/.app.jsonc with your app ID.

  4. Create the app's .env.local from the app ID that link wrote to base44/.app.jsonc.

    echo "VITE_BASE44_APP_ID=$(grep '"id"' base44/.app.jsonc | cut -d'"' -f4)" > .env.local

  5. Push your local entities and agents to Base44.

    base44 deploy

  6. Start development.

    npm run dev

    The app runs at http://localhost:5173/.

Features

  • Boards: Create and manage Kanban boards with custom colors.
  • Tasks: Add tasks with status, priority, due dates, and labels.
  • Teams: Collaborative workspaces with roles: admin, member, viewer.
  • Authentication: Email/password with OTP and Google OAuth.
  • AI assistant: In-app assistant when configured.

Project structure

trellix/
├── base44/                    # Base44 backend configuration
│   ├── config.jsonc           # Project configuration
│   ├── agents/                # AI agent instructions (optional)
│   └── entities/              # JSONC schemas (DB + typed SDK)
│       ├── board.jsonc         # Kanban boards: name, description, color
│       ├── task.jsonc          # Tasks: title, status, priority, due date, labels
│       ├── team.jsonc          # Teams for collaborative workspaces
│       ├── team-member.jsonc   # Membership with roles (admin/member/viewer)
│       ├── task-subscription.jsonc  # Task notification subscriptions
│       └── activity-log.jsonc  # Audit log for task actions
├── src/
│   ├── App.tsx                # Root component with routing
│   ├── App.css                # Global styles
│   ├── types.ts               # TypeScript type definitions
│   ├── sdk-client/            # Base44 SDK client
│   │   └── base44-client.ts   # createClient + entity exports
│   ├── components/            # Reusable UI components
│   │   ├── board/             # Board-related components
│   │   ├── sidebar/           # Navigation sidebar
│   │   └── task/              # Task card and modal
│   └── pages/                 # Page components
│       ├── auth.tsx           # Authentication page
│       ├── board-list.tsx     # Board listing/grid
│       ├── board-view.tsx     # Kanban board view
│       └── profile.tsx        # User profile
├── public/                    # Static assets
└── dist/                      # Build output

Tech stack

  • Base44: Backend for auth and data.
  • React: UI library.
  • TypeScript: Type-safe JavaScript.
  • Vite: Build tool and dev server.
  • CSS: Custom styles with no framework.

Available commands

Run these npm commands from the project root.

Command Description
npm run dev Start development server at http://localhost:5173.
npm run build Type-check and build for production.
npm run preview Preview production build locally.
npm run lint Run ESLint.

Base44 integration

Trellix uses Base44 for SDK setup, entities, and config:

  • Authentication: Email/password auth with OTP verification.
  • Database: Entity-based data storage with CRUD operations.

Troubleshooting

Here are possible issues and how to fix them.

App won't start or shows a blank page

  1. Make sure you've created .env.local with VITE_BASE44_APP_ID in step 4 of Get started.
  2. Run npm run dev from the trellix folder and check the terminal for errors.
  3. Confirm Node.js is v20.19.0 or higher: node -v.

API or login errors

  1. Ensure you're logged in by running base44 whoami.
  2. Verify the project is linked by checking that base44/.app.jsonc exists and contains your app ID.
  3. Push the latest configs with base44 deploy.

Build fails

Run npm run lint to check for type or lint errors. Fix any reported issues and try npm run build again.

See also