{"id":22586034,"url":"https://github.com/code-district-team/laravel-template","last_synced_at":"2026-04-13T06:09:04.225Z","repository":{"id":262601681,"uuid":"887719805","full_name":"Code-District-Team/laravel-template","owner":"Code-District-Team","description":"Laravel multi-tenant app template with domain-based separation, built-in auth, tenant-aware models, asset compilation, and modern frontend setup","archived":false,"fork":false,"pushed_at":"2024-11-25T13:06:31.000Z","size":206,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2025-02-02T17:54:45.416Z","etag":null,"topics":["authentication","axios","backend","bootstrap","composer","cors","domain-separation","eloquent","laravel","mariadb","multi-tenant","mvc","mysql","php","template","web-development"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Code-District-Team.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-13T06:57:43.000Z","updated_at":"2024-12-03T08:07:21.000Z","dependencies_parsed_at":"2024-11-13T10:20:16.511Z","dependency_job_id":"a819da2f-495d-4247-babe-860520422d71","html_url":"https://github.com/Code-District-Team/laravel-template","commit_stats":null,"previous_names":["code-district-team/laravel-template"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-District-Team%2Flaravel-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-District-Team%2Flaravel-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-District-Team%2Flaravel-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-District-Team%2Flaravel-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Code-District-Team","download_url":"https://codeload.github.com/Code-District-Team/laravel-template/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246068290,"owners_count":20718503,"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":["authentication","axios","backend","bootstrap","composer","cors","domain-separation","eloquent","laravel","mariadb","multi-tenant","mvc","mysql","php","template","web-development"],"created_at":"2024-12-08T07:10:37.710Z","updated_at":"2026-04-13T06:09:04.196Z","avatar_url":"https://github.com/Code-District-Team.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel Multi-tenant Application Template\n\nA Laravel-based multi-tenant application template that allows multiple organizations to use the same application instance while maintaining data isolation.\n\n## Features\n\n- Multi-tenant architecture with domain-based separation\n- Built-in authentication system with password reset functionality\n- Tenant-aware database queries and models\n- Asset compilation with Laravel Mix\n- Testing environment setup\n- CORS support\n- Modern frontend setup with Bootstrap and Axios\n\n## Prerequisites\n\nBefore you begin, ensure you have the following installed:\n\n### PHP \u003e= 8.1.6\n\n- **Windows**: Download the PHP installer from [php.net](https://windows.php.net/download/) and follow the installation instructions.\n- **macOS**: Use Homebrew:\n  ```bash\n  brew install php\n  ```\n- **Linux**: Use your distribution's package manager. For example, on Ubuntu:\n  ```bash\n  sudo apt update\n  sudo apt install php8.1\n  ```\n\n### Composer\n\n- **All Platforms**: Follow the instructions on the [Composer website](https://getcomposer.org/download/) to download and install Composer globally.\n\n### Node.js \u0026 NPM\n\n- **Windows/macOS/Linux**: Download the installer from the [Node.js website](https://nodejs.org/) and follow the installation instructions. This will install both Node.js and NPM.\n\n### MySQL \u003e= 5.7 or MariaDB \u003e= 10.3\n\n- **Windows/macOS/Linux**: Download and install MySQL from the [MySQL website](https://dev.mysql.com/downloads/installer/) or MariaDB from the [MariaDB website](https://mariadb.org/download/).\n\n### Git\n\n- **Windows**: Download and install Git from [git-scm.com](https://git-scm.com/).\n- **macOS**: Use Homebrew:\n  ```bash\n  brew install git\n  ```\n- **Linux**: Use your distribution's package manager. For example, on Ubuntu:\n  ```bash\n  sudo apt update\n  sudo apt install git\n  ```\n\n## Setup Guidelines\n\n1. **Clone the Repository**\n   ```bash\n   git clone https://github.com/your-username/your-repo-name.git\n   cd your-repo-name\n   ```\n\n2. **Install PHP Dependencies**\n   ```bash\n   composer install\n   ```\n\n3. **Install Node.js Dependencies**\n   ```bash\n   npm install\n   ```\n\n4. **Compile Assets**\n   ```bash\n   npm run dev\n   ```\n\n## Setting Up the Environment\n\n1. **Copy the Example Environment File**\n   ```bash\n   cp .env.example .env\n   ```\n\n2. **Generate Application Key**\n   ```bash\n   php artisan key:generate\n   ```\n\n3. **Configure Database Settings**\n   - Open the `.env` file and update the following lines with your database credentials:\n     ```\n     DB_CONNECTION=mysql\n     DB_HOST=127.0.0.1\n     DB_PORT=3306\n     DB_DATABASE=your_database_name\n     DB_USERNAME=your_database_user\n     DB_PASSWORD=your_database_password\n     ```\n\n## Running the Project Locally\n\n1. **Run Database Migrations**\n   ```bash\n   php artisan migrate\n   ```\n\n2. **Start the Development Server**\n   ```bash\n   php artisan serve\n   ```\n\n3. **Access the Application**\n   - Open your web browser and go to `http://localhost:8000`\n\n## Folder Structure\n\nHere's an overview of the project's folder structure:\n\n```plaintext\nyour-repo-name/\n├── app/\n│   ├── Console/\n│   ├── Exceptions/\n│   ├── Http/\n│   │   ├── Controllers/\n│   │   ├── Middleware/\n│   ├── Models/\n│   ├── Providers/\n│   └── ...\n├── bootstrap/\n├── config/\n├── database/\n│   ├── factories/\n│   ├── migrations/\n│   ├── seeders/\n├── public/\n├── resources/\n│   ├── js/\n│   ├── lang/\n│   ├── sass/\n│   └── views/\n├── routes/\n│   ├── api.php\n│   ├── channels.php\n│   ├── console.php\n│   └── web.php\n├── storage/\n│   ├── app/\n│   ├── framework/\n│   └── logs/\n├── tests/\n│   ├── Feature/\n│   └── Unit/\n├── vendor/\n├── .env.example\n├── artisan\n├── composer.json\n├── package.json\n└── webpack.mix.js\n```\n\n### Explanation\n\n- **app/**: Core application code, including models, controllers, and middleware.\n- **bootstrap/**: Framework bootstrap files.\n- **config/**: Configuration files.\n- **database/**: Migrations, factories, and seeders.\n- **public/**: Publicly accessible assets and front controller.\n- **resources/**: Views, raw assets, and language files.\n- **routes/**: Route definitions.\n- **storage/**: Compiled templates, sessions, caches, and logs.\n- **tests/**: Automated tests.\n- **vendor/**: Composer dependencies.\n\n## Additional Information\n\n- **Testing**: To run tests, use the following command:\n  ```bash\n  php artisan test\n  ```\n\n- **CORS Configuration**: If you need to configure CORS, you can do so in the `config/cors.php` file.\n\n- **Environment Variables**: Ensure all necessary environment variables are set in your `.env` file for proper application functionality.\n\n- **Contributing**: If you wish to contribute, please fork the repository and submit a pull request.\n\n- **License**: This project is licensed under the MIT License.\n\nFor any further questions or issues, please refer to the project's issue tracker or contact the maintainers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-district-team%2Flaravel-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode-district-team%2Flaravel-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-district-team%2Flaravel-template/lists"}