mirror of https://github.com/Mail-0/Zero.git synced 2026-03-03 02:17:01 +00:00

Files

Adam 01e2adf492 Redesign mail categories to use label-based filtering instead of search queries (#1902 )

# Redesigned Mail Categories with Label-Based Filtering

## Description

Reimplemented the mail categories feature to use label-based filtering instead of search queries. This change makes it easier for users to customize and manage their inbox views by selecting specific labels rather than writing complex search queries.

The PR enables the categories settings page in the navigation and completely redesigns the UI to focus on label selection. Users can now add, delete, reorder, and set default categories with a more intuitive interface.

## Type of Change

- ✨ New feature (non-breaking change which adds functionality)
- 🎨 UI/UX improvement

## Areas Affected

- [x] User Interface/Experience
- [x] Data Storage/Management

## Testing Done

- [x] Manual testing performed

## Checklist

- [x] I have performed a self-review of my code
- [x] My changes generate no new warnings
- [x] My code follows the project's style guidelines

## Additional Notes

The PR also includes improvements to the thread querying logic in the backend to better support label-based filtering. The categories feature is now called "Views" in the UI to better reflect its purpose.

---

_By submitting this pull request, I confirm that my contribution is made under the terms of the project's license._

<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit

* **New Features**
  * Categories settings page is now accessible from navigation.
  * Categories (now called "Views") can be managed with multi-select label filters, drag-and-drop reordering, add/delete actions, and unsaved changes tracking.
  * Save and reset options are available for category changes.

* **Improvements**
  * Category selection supports multi-label filtering with a dropdown menu.
  * UI styling updated for better dark mode support and usability.
  * Localization updated to rename "Categories" to "Views".
  * Navigation and mail list no longer use category query parameters, simplifying URL handling.

* **Bug Fixes**
  * Removed unused and AI-related code for category search queries.

* **Chores**
  * Added a pre-commit script to enforce linting before commits.
  * Refactored internal logic for category and thread management for better maintainability.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

2025-08-04 10:34:29 -07:00

3.8 KiB

Raw Permalink Blame History

Agent Configuration for Zero Email

Zero is an open-source AI email solution built with a modern TypeScript/Next.js stack in a monorepo setup.

Project Structure

This is a pnpm workspace monorepo with the following structure:

apps/mail/ - Next.js frontend email client
apps/server/ - Backend server
apps/ios-app/ - iOS mobile app
packages/cli/ - CLI tools (nizzy command)
packages/db/ - Database schemas and utilities
packages/eslint-config/ - Shared ESLint configuration
packages/tsconfig/ - Shared TypeScript configuration

Frequently Used Commands

Development

pnpm go - Quick start: starts database and dev servers
pnpm dev - Start all development servers (uses Turbo)
pnpm docker:db:up - Start PostgreSQL database in Docker
pnpm docker:db:down - Stop and remove database container
pnpm docker:db:clean - Stop and remove database with volumes

Build & Deploy

pnpm build - Build all packages (uses Turbo)
pnpm build:frontend - Build only the mail frontend
pnpm deploy:frontend - Deploy frontend
pnpm deploy:backend - Deploy backend

Code Quality

pnpm check - Run format check and lint
pnpm lint - Run ESLint across all packages
pnpm format - Format code with Prettier
pnpm check:format - Check code formatting

Database

pnpm db:push - Push schema changes to database
pnpm db:generate - Generate migration files
pnpm db:migrate - Apply database migrations
pnpm db:studio - Open Drizzle Studio

Testing & Evaluation

pnpm test:ai - Run AI tests
pnpm eval - Run evaluation suite
pnpm eval:dev - Run evaluation in dev mode
pnpm eval:ci - Run evaluation in CI mode

Utilities

pnpm nizzy env - Setup environment variables
pnpm nizzy sync - Sync environment variables and types
pnpm scripts - Run custom scripts

Tech Stack

Frontend: Next.js, React 19, TypeScript, TailwindCSS, Shadcn UI
Backend: Node.js, tRPC, Drizzle ORM
Database: PostgreSQL
Authentication: Better Auth, Google OAuth
Package Manager: pnpm (v10+)
Build Tool: Turbo
Linting: ESLint, Oxlint, Prettier

Code Style & Conventions

Formatting

2-space indentation
Single quotes
100 character line width
Semicolons required
Uses Prettier with sort-imports and Tailwind plugins

File Organization

TypeScript strict mode enabled
Workspace packages use catalog versioning for shared dependencies
Monorepo managed with pnpm workspaces

Important Environment Variables

BETTER_AUTH_SECRET - Auth secret key
GOOGLE_CLIENT_ID & GOOGLE_CLIENT_SECRET - Gmail integration
AUTUMN_SECRET_KEY - Encryption service
TWILIO_* - SMS integration
DATABASE_URL - PostgreSQL connection string

Development Setup

Install dependencies: pnpm install
Setup environment: pnpm nizzy env
Sync environment: pnpm nizzy sync
Start database: pnpm docker:db:up
Initialize database: pnpm db:push
Start development: pnpm dev

Common Workflow

Always run pnpm check before committing
Use pnpm nizzy sync after environment variable changes
Run pnpm db:push after schema changes
Use pnpm go for quick development startup

Notes

Uses Husky for git hooks
Integrates with Sentry for error tracking
Uses Cloudflare Workers for backend deployment
iOS app is part of the monorepo
CLI tool nizzy helps manage environment and sync operations

IMPORTANT RESTRICTIONS

NEVER run project-wide lint/format commands (pnpm check, pnpm lint, pnpm format, pnpm check:format)
These commands format/lint the entire codebase and cause unnecessary changes
Only use targeted linting/formatting on specific files when absolutely necessary
Focus on the specific task at hand without touching unrelated files

3.8 KiB Raw Permalink Blame History