Home

🧩 EpiTrello — Wiki

Welcome to the EpiTrello documentation wiki 👋
This wiki explains the project goals, tech stack, architecture, and how to install and use the application.

---

📌 Project Overview

EpiTrello is a Trello-like web application built around a Kanban workflow.
Users can create boards, manage columns, create tasks, move tasks between columns (drag & drop), and filter tasks to stay organized.

The app is designed to be clean, responsive, secure, and easy to maintain ✅

---

🖼️ App Preview (Screenshots)

• Landing Page
  

• Dashboard (Boards list / grid)
  

• Board (Kanban view)
  

• Create Task Dialog
  

---

✨ Key Features

• 🔐 Authentication with Clerk (Sign in / Sign up)
• 📊 Dashboard with boards list, grid/list view, search, and quick actions
• 🎨 Boards management (create, edit board name & color)
• 🧱 Kanban workflow
  • Columns rendering & ordering
  • Task creation (dialog)
  • Drag & drop between columns
  • Board-level task filtering
• 🗄️ Database powered by Supabase (tables, relations, indexes)
• 🛡️ Security with Supabase Row Level Security (RLS) policies
• 🚀 Landing page introducing the app + call-to-action to create an account

---

🧰 Tech Stack

• 🖥️ Frontend: Next.js + TypeScript
• 🎛️ UI: Tailwind CSS + Shadcn UI
• 🔑 Authentication: Clerk
• 🗃️ Database & API: Supabase (PostgreSQL)
• 🛡️ Security: RLS policies (per-user data isolation)

📎 See: Technology Stack Justification

---

🚀 Getting Started

To run the project locally, you will need:

• ✅ Node.js (LTS recommended)
• ✅ A Supabase project (URL + anon key)
• ✅ A Clerk project (publishable key + secret key)

➡️ Setup guide: Getting Started (coming soon)

---

🗂️ Wiki Pages (Table of Contents)

• 🚀 Getting Started
• 🧠 Architecture Overview
• 🗃️ Database Schema
• 🛡️ RLS Policies & Security
• 📘 Features Guide (User Manual)
• 🧪 Testing (Unit & Integration)
• 🔁 CI/CD Pipeline
• 🧾 Technology Stack Justification
• 🧯 Troubleshooting

---

🤝 Contributing / Team Workflow

• ✅ Use meaningful commit messages
• 🔍 Prefer small PRs with clear descriptions
• ♻️ Keep UI components reusable and consistent with the design system
• 🚫 Never commit secrets (.env files)

---

🆘 Support

If something breaks or you encounter unexpected behavior:

• 🧯 Check the Troubleshooting page (coming soon)
• 🔐 Review Supabase RLS policies and environment variables
• 🐛 Create an issue with steps to reproduce