{"id":22724295,"url":"https://github.com/jpchip/fssk-laravel","last_synced_at":"2026-04-07T07:38:04.572Z","repository":{"id":149217931,"uuid":"118783931","full_name":"jpchip/fssk-laravel","owner":"jpchip","description":"Full Stack Starter Kit, using PHP/Laravel for server instead of Node.","archived":false,"fork":false,"pushed_at":"2018-05-01T19:27:13.000Z","size":441,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-03T14:25:25.248Z","etag":null,"topics":["docker","laravel","php","postgresql","react","typescript"],"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/jpchip.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2018-01-24T15:28:26.000Z","updated_at":"2018-10-28T02:00:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"2c9ea4b4-d312-4100-9378-525e4354b534","html_url":"https://github.com/jpchip/fssk-laravel","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jpchip/fssk-laravel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpchip%2Ffssk-laravel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpchip%2Ffssk-laravel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpchip%2Ffssk-laravel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpchip%2Ffssk-laravel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jpchip","download_url":"https://codeload.github.com/jpchip/fssk-laravel/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpchip%2Ffssk-laravel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31504897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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","laravel","php","postgresql","react","typescript"],"created_at":"2024-12-10T14:15:38.275Z","updated_at":"2026-04-07T07:38:04.539Z","avatar_url":"https://github.com/jpchip.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# FSSK - Laravel\n\u003e Full Stack Starter Kit Laravel Playground\n\nFull Stack Starter Kit, but using PHP/Laravel for server instead of Node.\n\n## Installing / Getting started\n\nFirst, clone the project. Copy `server/.env.example` to `server/.env` and `client/.env.example` to `client/.env`\n\nRun the following command:\n\n```shell\ndocker-compose up -d\n```\n\nThis will first build the image based off the project's `Dockerfile`.  After the image is built, it will start and the current working directory will be mounted to the app container's `/opt/src`.\n\nThis spins up a postgres instance, starts client at `http://localhost:3000`\nand starts server at `http://localhost:4000`. Server calls are proxied, so `http://localhost:3000/api/users` will hit `http://localhost:4000/api/users` automagically.\n\nTo init the database:\n\n```shell\ndocker exec -it server php server/artisan migrate --seed\n```\n\n\n## Developing\n\n### Built With\n\nThe current technologies used by the starter kit are as follows:\n\n| Type | Selected Technology | Reasoning |\n| ---- | ------------------- | --------- |\n| Transpiler | [TypeScript](https://www.typescriptlang.org/) | Static types make for code that is less buggy and easier to reason about.  A basic TypeScript cheatsheet can be found [here](https://www.sitepen.com/blog/2013/12/31/typescript-cheat-sheet/) and more extensive documentation [here](https://www.typescriptlang.org/docs/tutorial.html) and [here](https://www.sitepen.com/blog/2013/12/31/definitive-guide-to-typescript/) |\n| View Library | [React](https://facebook.github.io/react/) | Component-based views that encourage single-directional data flow |\n| Client-side State Management | [MobX](https://github.com/mobxjs/mobx) | Simpler than Redux and requires less boilerplate |\n| Backend Server | [Laravel](https://laravel.com/docs/5.5) | Well documented and widely supported web framework |\n| API Protocol | REST | A familiar paradigm to most developers |\n| Data Mapping Framework | [Eloquent ORM](https://laravel.com/docs/5.5/eloquent) | Included with Laravel |\n| Database Migrations | [Laravel Migrations](https://laravel.com/docs/5.5/migrations) | Provided by Laravel, so no additional dependencies |\n| Data Store | [PostgreSQL](https://www.postgresql.org/) | Open source, rock solid, industry standard |\n| Package Manager | [npm](https://www.npmjs.com/) / [composer](https://getcomposer.org/) | The battle-tested choices for node/php development |\n| Containerization | [Docker](https://www.docker.com/) | Containers make deployment easy |\n| Testing Framework | [Jest](https://facebook.github.io/jest/)  / [PHPUnit](https://phpunit.de/) | Complete testing package with an intuitive syntax |\n| Linter | [tslint](https://github.com/palantir/tslint) | Keeps your TypeScript code consistent |\n\n### Prerequisites\n\n- Docker\n\n### Setting up Dev\n\nSee Getting Started section for steps.\n\nOnce spun up, you can shell into the client or server instances like:\n\n```shell\ndocker exec -it client bash\n```\n\n```shell\ndocker exec -it server bash\n```\n\n### Building\n\nBuild client side code:\n\n```shell\ncd client/ \u0026\u0026 npm run build\n```\n\n### Deploying / Publishing\n\nUpdate your `.env` files to indicate a production build, like `NODE_ENV=production` and `APP_ENV=production`. \n\n```shell\ndocker-compose -f docker-compose-prod.yml up\n```\n\nWill build the client code, spin up the server in a docker instance with `http://localhost:4000/` pointing to the client's index.html and built js/css.\n\nNext, you should generate a new application key for the production environment:\n\n```shell\ndocker exec -it server php server/artisan key:generate\n```\n\nAnd run the database migrations:\n\n```shell\ndocker exec -it server php server/artisan migrate\n```\n\nTo eek out best performance, should also run `php server/artisan config:cache` and `php server/artisan route:cache`, and make sure `APP_DEBUG` is false.\n\n## Configuration\n\nSee the .env.example files in client and server directories.\n\n## Tests\n\nClient and Server code each have their own tests, using Jest.\n\n```shell\nnpm test\n```\n\nand \n\n```shell\ncd server \u0026\u0026 ./vendor/bin/phpunit\n```\n\n## Artisan\n\nLaravel has a CLI tool called [Artisan](https://laravel.com/docs/5.5/artisan). To use it:\n\n```shell\ndocker exec -it server php server/artisan YOUR_COMMAND\n```\n\nDo `list` to see available commands.\n\n### How to make a new API endpoint\n\n- Make Model and DB Migration:\n\n```\nphp artisan make:model Todo -m\n```\n\n-  Make Controller:\n\n```\nphp artisan make:controller TodoController --resource --model=Todo\n```\n\n-  Add Routes\n\n```\nRoute::apiResource('todos', 'TodoController');\n```\n\n-  Add Authorization Policies:\n\n```\nphp artisan make:policy TodoPolicy --model=Todo\n```\n\nRegister policy in `AuthServiceProvider`:\n\n```\nTodo::class =\u003e TodoPolicy::class,\n```\n\n\n## Style guide\n\nTBD\n\n## Api Reference\n\nTBD\n\n## Database\n\nUsing postgres v9.6. For local development, database runs in docker container. `server/database` contains init script, migrations, and seeds.\n\nYou can connect to the database with your favorite client at `localhost:5432`!\n\n#### Run migrations:\n\n```shell\nphp artisan migrate\n```\n\n#### Run seeds:\n\n```shell\nphp artisan db:seed\n```\n\n#### Create new seeds:\n\n```shell\nphp artisan make:seeder TodosTableSeeder\n```\n\nAdd it to `DatabaseSeeder.php`:\n\n```\n$this-\u003ecall(TodosTableSeeder::class);\n```\n\n## Licensing\n\n[MIT License](LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpchip%2Ffssk-laravel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjpchip%2Ffssk-laravel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpchip%2Ffssk-laravel/lists"}