{"id":16646912,"url":"https://github.com/stevegrunwell/pupper","last_synced_at":"2025-10-30T14:30:59.549Z","repository":{"id":55323958,"uuid":"193369156","full_name":"stevegrunwell/pupper","owner":"stevegrunwell","description":"A Twitter clone for use in training courses","archived":false,"fork":false,"pushed_at":"2021-01-05T15:14:09.000Z","size":786,"stargazers_count":3,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-05-02T05:34:17.211Z","etag":null,"topics":["laravel","training","twitter","vuejs"],"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/stevegrunwell.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}},"created_at":"2019-06-23T16:10:42.000Z","updated_at":"2021-10-08T04:44:08.000Z","dependencies_parsed_at":"2022-08-14T21:10:28.789Z","dependency_job_id":null,"html_url":"https://github.com/stevegrunwell/pupper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevegrunwell%2Fpupper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevegrunwell%2Fpupper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevegrunwell%2Fpupper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevegrunwell%2Fpupper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stevegrunwell","download_url":"https://codeload.github.com/stevegrunwell/pupper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219856262,"owners_count":16556085,"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","training","twitter","vuejs"],"created_at":"2024-10-12T08:43:25.291Z","updated_at":"2025-10-30T14:30:54.074Z","avatar_url":"https://github.com/stevegrunwell.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pupper\n\nPupper is a Twitter clone, built for the purpose of demonstrating basic Laravel functionality (as well as automated testing).\n\n## Installation\n\nThe project comes pre-packaged with a [Laravel Homestead instance](https://laravel.com/docs/master/homestead), which contains everything needed to run the project.\n\n### Host machine requirements and installation\n\n* [Composer](https://getcomposer.org/download/) — PHP package manager, used for installing dependencies\n* [Vagrant](https://www.vagrantup.com/downloads.html) — Virtual Machine manager\n* At least **one** of the following virtualization platforms:\n    - [VirtualBox](https://www.virtualbox.org/wiki/Downloads)\n    - [VMWare](https://www.vmware.com/)\n    - [Parallels](https://www.parallels.com/products/desktop/)\n    - [Hyper-V](https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v)\n* [Vagrant Host Manager plugin](https://github.com/devopsgroup-io/vagrant-hostmanager) (required in some environments)\n\nOnce those dependencies are satisfied, clone the project from GitHub and install its dependencies:\n\n```sh\n# Clone the project to a local directory\n$ git clone git@github.com:stevegrunwell/pupper.git\n\n# Move into the project directory\n$ cd pupper\n\n# Install Composer dependencies\n$ composer install --ignore-platform-reqs\n```\n\nDon't worry about the version of PHP you're running locally, the `composer.json` file tells Composer to install as though we're using PHP 7.3 (which will be pre-configured in the Homestead virtual machine).\n\n### Creating the Homestead VM\n\nOnce the project has been cloned and its dependencies installed, it's time to start up our Laravel Homestead virtual machine!\n\nThis process has been heavily-scripted for you, so getting up and running with the project should be as simple as:\n\n```sh\n# Create the necessary Homestead files\n$ composer homestead\n\n# Provision the virtual machine\n$ vagrant up\n```\n\nIf everything worked properly, Pupper should be accessible via \u003chttps://pupper.test\u003e.\n\n## Running tests\n\nThe application test suite is written using [PHPUnit](https://phpunit.de/), installed via Composer. The test suite may be run at any time by running the following from within the VM:\n\n```sh\n$ ./vendor/bin/phpunit\n```\n\nYou may also use the following Composer script from within the Homestead VM to run all tests (PHPUnit, coding standards, static code analysis, etc.):\n\n```sh\n$ composer test\n```\n\n### Coding standards\n\nPupper is written according to the [PSR-2 coding standard](https://www.php-fig.org/psr/psr-2/) and ships with configurations for [PHP_CodeSniffer](https://github.com/squizlabs/PHP_CodeSniffer) and [PHP Coding Standards Fixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer) for verifying adherence to these standards.\n\nYou may run the coding standards checks at any time by running the following Composer script from within the VM:\n\n```sh\n$ composer coding-standards\n```\n\n### Static code analysis\n\nThe Pupper repository also includes a [PHPStan](https://github.com/phpstan/phpstan) configuration for performing static code analysis:\n\n```sh\n$ composer static-analysis\n```\n\n\n### Code coverage reports\n\nA custom Composer script has been registered to generate HTML code coverage reports, which help highlight areas that may be under-tested.\n\nTo generate the reports, run the following:\n\n```sh\n$ composer test-coverage\n```\n\nThe reports will be available at \u003chttps://pupper.test/test-coverage\u003e.\n\n## Credits\n\nIconography for the application comes from [The Noun Project](https://thenounproject.com/), and is used under a Creative-Commons License:\n\n* [Dog by Sara Quintana](https://thenounproject.com/term/dog/62011)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevegrunwell%2Fpupper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstevegrunwell%2Fpupper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevegrunwell%2Fpupper/lists"}