Manage your projects with style! Create boards, organize tasks, collaborate with teams, and track progress with an intuitive drag-and-drop interface.
- β Multiple Boards: Create and switch between different project boards
- β Drag & Drop: Smooth card and list reordering with visual feedback
- β Real-time Updates: Instant synchronization across all connected clients
- β Responsive Design: Optimized for desktop, tablet, and mobile devices
- β Card Operations: Create, edit, archive, and delete cards
- β Rich Descriptions: Support for formatted text and markdown
- β Due Dates: Set and track deadlines with visual indicators
- β Checklists: Break down tasks into manageable subtasks
- β Labels: Color-coded categorization system
- β Cover Images: Add visual context to cards
- β Team Members: Add and manage workspace members
- β Card Assignment: Assign members to specific tasks
- β Comments: Threaded discussions on cards
- β Attachments: Upload files and add links
- β Activity Logs: Track all changes and updates
- β Board Themes: Multiple background options including Trello Classic
- β Custom Colors: Personalize with color picker
- β Member Avatars: Custom initials and color schemes
- β Dark/Light Modes: Adaptive theming (planned)
- β Search: Find cards by title instantly
- β Filtering: Filter by labels, members, due dates, and status
- β Keyboard Shortcuts: Power user shortcuts for efficiency
- β Export/Import: Data portability options
- β‘ Next.js 15 - React framework with App Router
- βοΈ React 18 - UI library with hooks and concurrent features
- π¨ CSS Modules - Scoped styling with responsive design
- π― @hello-pangea/dnd - Advanced drag-and-drop functionality
- π date-fns - Modern date utility library
- π Lucide React - Beautiful icon library
- π’ Node.js - Runtime environment
- π Next.js API Routes - Serverless API endpoints
- ποΈ Prisma ORM - Type-safe database operations
- π PostgreSQL - Robust relational database
- βοΈ Neon - Serverless PostgreSQL hosting
- π Vercel - Deployment and hosting platform
- π¦ npm - Package management
- π― ESLint - Code quality and linting
- π§ Prisma CLI - Database management
- π Git - Version control
- Node.js 18+ installed
- npm or yarn package manager
- Git for version control
-
Clone the repository
git clone https://github.com/yourusername/taskorbit-board.git cd taskorbit-board -
Install dependencies
npm install
-
Start development server
npm run dev
-
Open your browser
http://localhost:3000
For full persistence, set up PostgreSQL:
- Create a Neon database (or any PostgreSQL instance)
- Add environment variable
echo "DATABASE_URL=your_postgresql_connection_string" > .env
- Initialize database
npx prisma generate npx prisma db push npm run seed
- Click the "Add Board" button
- Choose a background theme
- Start adding lists and cards
- Add Lists: Click "Add List" to create columns
- Create Cards: Click "Add Card" within any list
- Drag & Drop: Move cards between lists or reorder them
- Edit Details: Click any card to open the detail modal
- Add Members: Use the member panel to add team members
- Assign Tasks: Drag members onto cards
- Add Comments: Discuss tasks directly on cards
- Attach Files: Upload images, documents, or links
taskorbit-board/
βββ app/ # Next.js app directory
β βββ api/ # API routes
β βββ globals.css # Global styles
β βββ layout.js # Root layout
β βββ page.js # Home page
βββ backend/ # Backend logic
β βββ board-repository.js # Data access layer
β βββ prisma.js # Database client
β βββ store.js # In-memory fallback
βββ frontend/ # Frontend components
β βββ components/ # Reusable UI components
β βββ styles/ # Component styles
βββ prisma/ # Database schema
β βββ schema.prisma # Prisma schema
β βββ seed.js # Database seeding
βββ public/ # Static assets
βββ shared/ # Shared utilities
βββ board-state.js # Initial state
βββ board-themes.js # Theme definitions
npm run dev # Start development server
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint
npm run seed # Seed the databasenpx prisma studio # Open Prisma Studio
npx prisma db push # Push schema changes
npx prisma generate # Generate Prisma clientCreate a .env file in the root directory:
DATABASE_URL=postgresql://username:password@host:port/database- Connect your repository to Vercel
- Add environment variables in Vercel dashboard
- Deploy automatically on every push
npm run build
npm run startWe welcome contributions! Please follow these steps:
- Fork the repository
- Create a feature branch
git checkout -b feature/amazing-feature
- Commit your changes
git commit -m 'Add amazing feature' - Push to the branch
git push origin feature/amazing-feature
- Open a Pull Request
- Follow the existing code style
- Write meaningful commit messages
- Add tests for new features
- Update documentation as needed
This project is licensed under the MIT License - see the LICENSE file for details.
- Trello for the inspiration and design patterns
- Vercel for amazing deployment platform
- Neon for serverless PostgreSQL
- Prisma for the excellent ORM
- Next.js team for the fantastic framework
If you have any questions or need help:
- π§ Email: [email protected]
- π Issues: GitHub Issues
- π¬ Discussions: GitHub Discussions
Made with β€οΈ using Next.js, React, and Prisma