{"id":31287946,"url":"https://github.com/supravatm/laravel-v12-api-starter","last_synced_at":"2026-04-29T20:33:01.172Z","repository":{"id":311881646,"uuid":"1043127129","full_name":"supravatm/laravel-v12-api-starter","owner":"supravatm","description":"Laravel 12.x  dokerize Rest Api Application with Sanctum Authentication","archived":false,"fork":false,"pushed_at":"2025-09-02T14:50:55.000Z","size":439,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-24T11:51:18.383Z","etag":null,"topics":["docker-compose","docker-container","laravel-api-","laravel-api-access-token","laravel-with-san","laravel12-api","laravel12-sanctum","laravel12x","postman","rest-api","restfull-api","sanctum","sanctum-authen","sanctum-authentication"],"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/supravatm.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-23T07:37:42.000Z","updated_at":"2025-09-02T14:58:59.000Z","dependencies_parsed_at":"2025-09-02T16:17:59.299Z","dependency_job_id":null,"html_url":"https://github.com/supravatm/laravel-v12-api-starter","commit_stats":null,"previous_names":["supravatm/laravel-api-starter-kit","supravatm/laravel-v12-api-starter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/supravatm/laravel-v12-api-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supravatm%2Flaravel-v12-api-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supravatm%2Flaravel-v12-api-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supravatm%2Flaravel-v12-api-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supravatm%2Flaravel-v12-api-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supravatm","download_url":"https://codeload.github.com/supravatm/laravel-v12-api-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supravatm%2Flaravel-v12-api-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32443517,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T20:22:27.477Z","status":"ssl_error","status_checked_at":"2026-04-29T20:22:26.507Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["docker-compose","docker-container","laravel-api-","laravel-api-access-token","laravel-with-san","laravel12-api","laravel12-sanctum","laravel12x","postman","rest-api","restfull-api","sanctum","sanctum-authen","sanctum-authentication"],"created_at":"2025-09-24T11:37:25.660Z","updated_at":"2026-04-29T20:33:01.152Z","avatar_url":"https://github.com/supravatm.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003ch1 align=\"center\"\u003e\n Laravel 12.x Rest API Starter Kit with Docker\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"public/img/laravel-and-docker.webp\" width=\"400\" alt=\"Laravel + Docker\"\u003e\u003c/p\u003e\n\n\u003ch5 align=\"center\"\u003e\nA Laravel \u0026 Docker Development Setup\n\u003c/h5\u003e\n\n## Features\n\n- **Laravel 12** REST API starter, ready for develop and customization.\n- **Dockerized environment**: PHP-FPM , Nginx, MySQL, phpMyAdmin, and Mailhog.\n- **Easy setup** with Docker Compose.\n- **Postman** API documentation link for quick reference.\n\n## Services Overview (`docker-compose.yaml`)\n\n| Service      | Description                                   | Ports         | Healthcheck      |\n|--------------|-----------------------------------------------|---------------|------------------|\n| **app**      | PHP-FPM container for Laravel                 | -             | Yes (depends on DB) |\n| **nginx**    | Web server serving the application            | 80:80         | -                |\n| **database** | MySQL 8.0 database                           | 3306:3306     | Yes              |\n| **phpmyadmin** | Database management UI                    | 8888:80       | Yes (depends on DB) |\n| **mailpit**  | Email testing tool (SMTP + web UI)           | 1025:1025, 8025:8025 | Yes          |\n\n---\n\n## Quick Start\n\n### 1. Clone the Repository\n\n```sh\ngit clone git@github.com:supravatm/laravel-v12-api-starter.git\ncd laravel-v12-api-starter\n```\n\n### 2. Install Dependencies\n\n```sh\ndocker run --rm -v \"$(pwd)\":/app composer install\n```\n\n### 3. Configure Environment Variables\n\nUpdate your `.env` file for database credential:\n\n```env\nDB_CONNECTION=mysql\nDB_HOST=database\nDB_PORT=3306\nDB_DATABASE=database\nDB_USERNAME=user\nDB_PASSWORD=password\n```\n\n### 4. Start Containers\n\n```sh\ndocker-compose up -d\n```\n\n\u003e **Note:** Some containers wait for the database service to be healthy before starting.\n\n### 5. Laravel Setup\n\nRun the following initialization commands:\n\n```sh\ndocker-compose exec app php artisan key:generate\ndocker-compose exec app php artisan optimize\ndocker-compose exec app php artisan session:table\ndocker-compose exec app php artisan migrate\ndocker-compose exec app php artisan cache:clear\n```\n\n## Accessing Services\n\n- **App (Nginx):** [http://localhost](http://localhost)\n- **phpMyAdmin:** [http://localhost:8888](http://localhost:8888)\n  - Use DB credentials from your `.env` file.\n- **Mailpit UI:** [http://localhost:8025](http://localhost:8025)\n  - SMTP: `localhost:1025` (for development email delivery)\n\n---\n\n## Email Testing\n\nMailpit is use for email testing. It stores messages and provides a web interface to view sent emails.  \nNo extra configuration needed for Laravel; just set the following in your `.env`:\n\n```env\nMAIL_MAILER=smtp\nMAIL_HOST=mailpit\nMAIL_PORT=1025\nMAIL_USERNAME=null\nMAIL_PASSWORD=null\nMAIL_ENCRYPTION=null\n```\n\n---\n\n## API Testing\n\n\u003cp align=\"center\"\u003e\n    \u003cimg align=\"center\" src=\"https://raw.githubusercontent.com/supravatm/laravel-v12-api-starter/main/public/img/postment-document-screenshot.png\" alt=\"Preview\" width=\"80%\" /\u003e\n\n\u003c/p\u003e\n\u003c/br\u003e\n\u003cp style=\"font-weight: bold;\"\u003e\nComplete REST API Documentation can be found \u003ca href=\"https://documenter.getpostman.com/view/497605/2sB3BLjnwZ\" target=\"_blank\" rel=\"noopener noreferrer\"\u003ehere\u003c/a\u003e\n\u003c/p\u003e\n\n## Troubleshooting\n\n- Ensure Docker Desktop (or Docker Engine) is running.\n- If containers fail to start, use `docker-compose logs` for details.\n- Database and phpMyAdmin may take a moment to become healthy.\n\n---\n\n## License\n\n[MIT](https://opensource.org/licenses/MIT)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupravatm%2Flaravel-v12-api-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupravatm%2Flaravel-v12-api-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupravatm%2Flaravel-v12-api-starter/lists"}