README.md

🌟 Alliora - Modern Project Management System (Test it here!)

Alliora is your ultimate tool for managing projects and teams with style and efficiency. Built with the latest technologies, it offers a powerful blend of real-time updates, interactive dashboards, and seamless collaboration tools.

---

🚀 Why Choose Alliora?

• 📂 Project Management
  Organize your projects with precision and keep everything on track.

• 📝 Task Boards
  Manage your tasks visually with drag-and-drop Kanban boards.
  

• 💬 Team Collaboration
  Chat with your team and stay updated with real-time notifications.
  

• 📊 Analytics & Insights
  Gain actionable insights with charts and project statistics.
  

• 📅 Export your projects to Google Calendar
  Synchronize your schedule with Google Calendar for better project management.
  

---

🔑 Core Features

🌟 Key Capabilities

• Project Creation & Management
• Kanban-Style Task Boards with drag-and-drop functionality.
• Real-time Notifications & Updates via WebSocket integration.
• Team Chat for effective communication.
• Comprehensive Analytics & Charts for better decision-making.
• Google Calendar Integration to keep tasks synced across platforms.

---

🛠️ Technical Stack

Technology	Details
Backend	Laravel 11
Frontend	React with Inertia.js
Real-time Updates	Pusher + Laravel Echo
UI Components	Shadcn Components, Aceternity, Tailwind CSS
Drag-and-Drop	React Beautiful DnD
Database	SQLite
Charts	Shadcn Charting Components

---

⚡ Getting Started

Prerequisites

Before installation, ensure your environment meets the following requirements:

• PHP >= 8.1
• Composer
• Node.js & NPM
• SQLite

Installation Steps

1. Clone the Repository

   git clone https://github.com/wav-rover/Alliora.git

2. Install Dependencies

   • Backend

     composer install

   • Frontend

     npm install

3. Set Environment Variables

   • Copy the .env file:

     cp .env.example .env

   • Configure the following keys in .env:
     • PUSHER KEYS needed for realtime updates on boards (get them from Pusher Dashboard).
     • GOOGLE KEYS optionnal, used for exporting tasks to Google Calendar (get them from Google Cloud Console).

4. Generate Application Key

   php artisan key:generate

5. Run Migrations

   php artisan migrate

6. Start the Development Servers

   • Backend:

     php artisan serve

   • Frontend:

     npm run dev

---

🤝 Contributing

We’re thrilled about your interest in contributing to Alliora! Here’s how you can help:

1. Fork the repository.
2. Create a feature branch:

   git checkout -b feature-name

3. Commit your changes and submit a pull request!

---

🔐 Security Vulnerabilities

If you identify a security issue, please contact our security team directly. We prioritize user safety and will address all vulnerabilities promptly.

---

📜 License

Alliora is not officially licensed as open-source software. It is a study project developed for educational purposes.

---

🎉 Experience effortless project management with Alliora!