{"id":20745281,"url":"https://github.com/techins-software/laravel-boilerplace","last_synced_at":"2026-02-14T01:31:49.566Z","repository":{"id":257410785,"uuid":"858231953","full_name":"TechIns-Software/laravel-boilerplace","owner":"TechIns-Software","description":"Boilerplate code for Laravel projects. It contains basic files for bootstrapping and deploying laravel applications ","archived":false,"fork":false,"pushed_at":"2025-01-09T09:01:18.000Z","size":117,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-01T04:50:29.149Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/TechIns-Software.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,"zenodo":null}},"created_at":"2024-09-16T14:38:50.000Z","updated_at":"2025-01-09T09:01:08.000Z","dependencies_parsed_at":"2024-09-16T15:38:43.486Z","dependency_job_id":"8422b627-f97f-42fa-9082-1bc90fc2ea58","html_url":"https://github.com/TechIns-Software/laravel-boilerplace","commit_stats":null,"previous_names":["techins-software/laravel-boilerplace"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/TechIns-Software/laravel-boilerplace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechIns-Software%2Flaravel-boilerplace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechIns-Software%2Flaravel-boilerplace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechIns-Software%2Flaravel-boilerplace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechIns-Software%2Flaravel-boilerplace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TechIns-Software","download_url":"https://codeload.github.com/TechIns-Software/laravel-boilerplace/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechIns-Software%2Flaravel-boilerplace/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29429378,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T22:20:51.549Z","status":"ssl_error","status_checked_at":"2026-02-13T22:20:49.838Z","response_time":78,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-11-17T07:19:27.884Z","updated_at":"2026-02-14T01:31:49.550Z","avatar_url":"https://github.com/TechIns-Software.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel Boilerplate\n\nThis is a boileplace code for admin panels used by our projects. \nIt contains basic views and login functionality alongside with the nessesary files for deployment and testing.\nUpon frontend bootstrap is used.\n\n## Create project:\n\n```\ncomposer create-project techins-software/laravel-boilerplace my-new-project\n```\n\n## Setup php dependencies\n\nCreate the nessesary .env file. If using our docker solution use the `.env.php_dev`:\n\n```\ncp .env.php_dev .env\n```\n\n\u003e NOTE these credentials are viable if using the docker solution. It should NOT be used upon production\n\nThen once `.env` is generated run:\n\n```shell\ncomposer install\nphp artisan key:generate\nphp artisan migrate\n```\n\n## Build Frontend\n\nFor development you can run:\n```shell\nnpm install\nnpm run build_dev\n```\n\nFor onetime builds (or ci/cd ones) run:\n\n```shell\nnpm install\nnpm run build\n```\n\n## Github actions \u0026 CI/CD\nThe actions are used for:\n\n1. Automated Tagging\n2. Running Unit tests upon PR\n\nLook at `.github/workflows` folder for more info.\n\n## Deployment \u0026 Building for release upon Server (CI/CD)\n\nIt contains, the following basic files for building the AWS codepipeline. Also it contains the following files for deployment:\n\n* `appspec.production.yml` For Deployment in a production traditional LEMP Stack\n* `appspec.staging.yml` For Deployment in a staging traditional LEMP Stack\n\nAlso upon build the following files exist:\n\n* .env.production for bootstrapping environment upon production\n* .env.staging for bootstrapping environment upon staging\n\nAny secret values are and should be replaced upon `buildspec.yml`\n\n## View templates\n\nAll pages available for logged in users extend the `layout.layout-common` blade template. In case user is admin you can extend the `layout.layout-admin` one (it extends the `layout.layout-common` one placing nessesary links upon header).\nFeel free to place extra views and modify them as needed. \n\nThe `layout.fullpage` is a layout that does NOT contain any header but only a single main item located as the center of the page, usefull for login and registration pages.\n\nBoth `layout.layout-common` and `layout.fullpage` contain these sections you can place the nessesary html if needed:\n\n* `main` that main html resides\n* `nav-items` in which navigation items upon header are placed\n* `js` in which Javascript files are placed upon\n* `css` in which stylesheet is placed upon (NOT Available upon `layout.fullpage`)\n\nAll templates use bootstrap and fontawesome.\n\n## Javascript\nAll layouts extending `layout.layout-common`, by default load the `js/default.js` file. \nIn case that a custom javascript file is needed then place the appropriate js file upon `resources/js` and upon the blade template and override the `js` section, look examples bellow.\n\n### Example 1: overriding the default js with `resources/js/myjs.js`\n```blade\n@extends('layout.layout-common')\n\n@section('main')\n\n{{!! Your html content shown upon user !!}}\n\n@endsection\n\n@section('js')\n @vite(['resources/js/myjs.js'])\n@endsection\n\n```\n\n### Example 2: Loading `resources/js/myjs.js` alongside the default js\n```blade\n@extends('layout.layout-common')\n\n@section('main')\n\n{{!! Your html content shown upon user !!}}\n\n@endsection\n\n@section('js')\n @parent\n @vite(['resources/js/myjs.js'])\n@endsection\n\n```\n\n## Css\nThere are the following css loaded bty Default upon each template:\n\n* `resources/css/common.css` =\u003e loaded by any template it loads bootstrap and fontawesome.\n* `resources/css/fullpage.css` =\u003e loaded by any template using `layout.fullpage` in includes `resources/css/common.css`.\n* `reources/css/user/list.css` =\u003e loaded by template `user.listUsers` it includes `resources/css/common.css`.\n\nIn case you want to include your own css follow these steps:\n\n### Create css files  \nFirst create the nessesary css file upon `resources/css`. \nThen place inside inside the following:\n```css\n@import \"resources/css/common.css\";\n\n/** rest of css goes here */\n\n```\n### Load 3rtd party css\nFurthermore if using a fullpage layout and want to place extra css on it you can do it:\n\n```css\n@import \"resources/css/fullpage.css\";\n\n/*Rest of css goes here*/\n```\n\nYou can use `@import` to import any 3rd party css as well if needed. Is css is installed via npm ensure that is placed upon `vite.config.js` file:\nhttps://github.com/TechIns-Software/laravel-boilerplace/blob/6331fb7a1b9238f8e9f193c80e872f116b90245c/vite.config.js#L40-L52\n\n### Load upon blade\nEither case once you have your css ready you can load the file (assuming named as `resources/css/mycss.css`):\n\n```blade\n@section('css')\n  @vite(['resources/css/mycss.css'])\n@endif\n```\n### Build frontend\n\nThen you can build the frontend as mentioned above:\n\n```shell\nnpm run build_dev\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechins-software%2Flaravel-boilerplace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechins-software%2Flaravel-boilerplace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechins-software%2Flaravel-boilerplace/lists"}