diff --git a/README.md b/README.md index f94379b..c551bbb 100644 --- a/README.md +++ b/README.md @@ -1 +1,93 @@ # Scrummie-Poker + +
+ +
+ +Scrummie-Poker is a collaborative estimation tool for agile teams, designed to simplify story point estimation through a modern and intuitive interface. + +## Table of Contents + +- [Features](#features) +- [Tech Stack](#tech-stack) +- [Setup Instructions](#setup-instructions) +- [Contributing](#contributing) +- [License](#license) + +## Features + +- Create and manage estimation sessions +- Invite team members to join sessions +- Create or import tickets for estimation +- Real-time voting on ticket estimates +- User authentication and guest access + +## Tech Stack + +- **Frontend:** React, Vite + - **Libraries:** + - tanstack router (app routing) + - tanstack forms (form state management) + - yup (for validation) + - tailwindcss (for styling) + - ckeditor5 (for rich text editing) + - papaparse (for CSV ticket import) + - showdown (for markdown conversion) +- **Backend:** Appwrite + - **Capabilities:** + - Auth (user management) + - Databases (session and ticket storage) + - Realtime API (live updates) + - Functions (session invitations and username updates) + +## Setup Instructions + +### Prerequisites + +- Node.js (version 20 or later) or Bun +- Appwrite account and project setup (see [Appwrite Documentation](https://appwrite.io/docs)) + +### Clone the Repository + +```bash +git clone https://github.com/pikami/scrummie-poker.git +cd scrummie-poker +``` + +### Install Dependencies + +```bash +npm install +``` + +### Set Up Environment Variables + +Create a `.env` file in the root directory and add your Appwrite project credentials: + +``` +VITE_APPWRITE_ENDPOINT=https://