{"id":24054515,"url":"https://github.com/virajmadhu/larapm","last_synced_at":"2026-05-16T07:47:47.319Z","repository":{"id":271554336,"uuid":"913820420","full_name":"VirajMadhu/LaraPm","owner":"VirajMadhu","description":"LaraPm is a modern, open-source project management tool designed to simplify and enhance the way you manage projects, tasks, and team collaboration. Built on the robust Laravel 10 framework and powered by the elegant Filament Admin Panel, LaraPm offers a seamless user experience with powerful features and customizable workflows.","archived":false,"fork":false,"pushed_at":"2025-01-08T12:38:56.000Z","size":16295,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-08T13:51:29.631Z","etag":null,"topics":["laravel","laravel-framework-10","pmtool","projectmanagement"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VirajMadhu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-08T12:17:40.000Z","updated_at":"2025-01-08T12:39:00.000Z","dependencies_parsed_at":"2025-01-08T14:02:44.141Z","dependency_job_id":null,"html_url":"https://github.com/VirajMadhu/LaraPm","commit_stats":null,"previous_names":["virajmadhu/larapm"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirajMadhu%2FLaraPm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirajMadhu%2FLaraPm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirajMadhu%2FLaraPm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VirajMadhu%2FLaraPm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VirajMadhu","download_url":"https://codeload.github.com/VirajMadhu/LaraPm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240840044,"owners_count":19866164,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","laravel-framework-10","pmtool","projectmanagement"],"created_at":"2025-01-09T03:47:34.322Z","updated_at":"2025-11-21T07:03:34.629Z","avatar_url":"https://github.com/VirajMadhu.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LaraPm Development Setup\n\n\u003e If you want to configure the **LaraPm** platform in your development environment, follow the instructions below to get started!\n\n## 🛠️ Prerequisites\n\nBefore setting up the LaraPm platform, make sure you have the following tools installed in your development environment:\n\n- **[Composer](https://getcomposer.org/)**: Dependency management for PHP.\n- **[PNPM](https://pnpm.io/)**: Fast, disk space efficient package manager for JavaScript.\n\n## 📥 Installing the Project\n\nStart by cloning the project repository using Git:\n\n```bash\ngit clone https://github.com/VirajMadhu/LaraPm.git\n```\n\n## 📦 Installing Dependencies\n\nOnce the project is cloned, you'll need to install both **back-end** and **front-end** dependencies.\n\n1. Install **back-end** dependencies using Composer:\n\n```bash\ncomposer install\n```\n\n2. Install **front-end** dependencies using PNPM:\n\n```bash\npnpm install\n```\n\n## ⚙️ Configuration\n\nNext, you'll need to configure the platform's **environment variables**.\n\n### Step 1: Copy the `.env.example` File\n\nCopy the `.env.example` file to a new `.env` file in the root directory:\n\n```bash\ncp .env.example .env\n```\n\n### Step 2: Update Configuration Keys\n\nEdit the `.env` file to set the appropriate values for the following keys:\n\n| Key | Description |\n| --- | --- |\n| **APP_URL** | URL to access the platform. |\n| **DB_HOST** | Host IP address or hostname for your MySQL database. |\n| **DB_PORT** | Port used for MySQL database connection. |\n| **DB_DATABASE** | Name of your MySQL database. |\n| **DB_USERNAME** | Username for MySQL authentication. |\n| **DB_PASSWORD** | Password for MySQL authentication. |\n| **MAIL_HOST** | SMTP server hostname for email sending. |\n| **MAIL_PORT** | SMTP server port. |\n| **MAIL_USERNAME** | SMTP server username. |\n| **MAIL_PASSWORD** | SMTP server password. |\n| **MAIL_ENCRYPTION** | Encryption method for SMTP. |\n| **MAIL_FROM_ADDRESS** | Email address from which platform emails will be sent. |\n| **PUSHER_APP_ID** | Pusher application ID. |\n| **PUSHER_APP_KEY** | Pusher application key. |\n| **PUSHER_APP_SECRET** | Pusher application secret. |\n| **PUSHER_HOST** | Pusher host used. |\n| **PUSHER_APP_CLUSTER** | Pusher cluster (default: `mt1`). |\n| **GITHUB_ID** | GitHub app ID for GitHub login integration. |\n| **GITHUB_SECRET** | GitHub app secret for GitHub login integration. |\n| **GOOGLE_CLIENT_ID** | Google client ID for Google login integration. |\n| **GOOGLE_CLIENT_SECRET** | Google client secret for Google login integration. |\n| **FACEBOOK_CLIENT_ID** | Facebook client ID for Facebook login integration. |\n| **FACEBOOK_CLIENT_SECRET** | Facebook client secret for Facebook login integration. |\n| **TWITTER_CLIENT_ID** | Twitter client ID for Twitter login integration. |\n| **TWITTER_CLIENT_SECRET** | Twitter client secret for Twitter login integration. |\n\n### Step 3: Generate the Application Key\n\nAfter configuring the environment variables, generate the application key by running:\n\n```bash\nphp artisan key:generate\n```\n\n## 🧑‍💻 Queue Setup\n\nLaraPm uses a queue system for notifications and emails. To run the queue worker, execute the following command in the project root:\n\n```bash\nphp artisan queue:work\n```\n\n## 🗄️ Database Setup\n\nBefore running the platform, you'll need to set up the database.\n\n### Step 1: Create the Database\n\nCreate a new MySQL database with the settings specified in the `.env` file.\n\n### Step 2: Run Database Migrations\n\nRun the database migrations to set up the necessary tables:\n\n```bash\nphp artisan migrate\n```\n\n### Step 3: Seed the Database\n\nInsert default values (e.g., users, referentials, and permissions) into the database:\n\n```bash\nphp artisan db:seed\n```\n\n### Default User Credentials\n\nThe default user created during the seeding process will have the following credentials:\n\n- **Email**: `john.doe@larapm.app`\n- **Password**: `Passw@rd`\n\nThis user has **all permissions** associated with their account.\n\n## 🚀 Build \u0026 Run\n\nNow you're ready to build the assets and run the platform.\n\n### Step 1: Build Assets\n\n- For **production**:  \n  ```bash\n  pnpm run build\n  ```\n\n- For **development**:  \n  ```bash\n  pnpm run dev\n  ```\n\n### Step 2: Serve the Application\n\nYou can now serve the LaraPm platform as a **Laravel** application:\n\n- Run Laravel's built-in server:\n  ```bash\n  php artisan serve\n  ```\n\nOr, use your preferred **web server** (e.g., Nginx or Apache).\n\n### Step 3: Clear Caches\n\nFinally, clear all application caches:\n\n```bash\nphp artisan optimize:clear\n```\n\n## 🎉 You're All Set!\n\nEnjoy coding and building with the **LaraPm** platform! 😎\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvirajmadhu%2Flarapm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvirajmadhu%2Flarapm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvirajmadhu%2Flarapm/lists"}