{"id":14985398,"url":"https://github.com/aplus-framework/app","last_synced_at":"2025-05-14T10:06:38.098Z","repository":{"id":37206917,"uuid":"211104957","full_name":"aplus-framework/app","owner":"aplus-framework","description":"Aplus Framework App Project","archived":false,"fork":false,"pushed_at":"2025-04-21T20:45:56.000Z","size":573,"stargazers_count":581,"open_issues_count":1,"forks_count":23,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-05-07T15:32:08.261Z","etag":null,"topics":["aplus","aplus-framework","app","application","composer","config","database","framework","full-stack","gitlab","http","libraries","mvc","php","php8","phpoop","project","routing","session","skeleton"],"latest_commit_sha":null,"homepage":"https://aplus-framework.com/packages/app","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/aplus-framework.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"natanfelles","liberapay":"aplus-framework","custom":["https://aplus-framework.com/sponsor"]}},"created_at":"2019-09-26T14:09:31.000Z","updated_at":"2025-04-23T23:29:57.000Z","dependencies_parsed_at":"2024-05-28T23:02:31.849Z","dependency_job_id":"6ead4a1c-b790-4a8b-93f4-ecffdfbe35bb","html_url":"https://github.com/aplus-framework/app","commit_stats":{"total_commits":378,"total_committers":1,"mean_commits":378.0,"dds":0.0,"last_synced_commit":"a58f8c3cb88328f97e434c3d62fc500fa1d897fe"},"previous_names":[],"tags_count":46,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aplus-framework%2Fapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aplus-framework%2Fapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aplus-framework%2Fapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aplus-framework%2Fapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aplus-framework","download_url":"https://codeload.github.com/aplus-framework/app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254119480,"owners_count":22017951,"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":["aplus","aplus-framework","app","application","composer","config","database","framework","full-stack","gitlab","http","libraries","mvc","php","php8","phpoop","project","routing","session","skeleton"],"created_at":"2024-09-24T14:10:53.442Z","updated_at":"2025-05-14T10:06:38.047Z","avatar_url":"https://github.com/aplus-framework.png","language":"PHP","readme":"\u003ca href=\"https://github.com/aplus-framework/app\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/aplus-framework/app/master/guide/image.png\" alt=\"Aplus Framework App Project\" align=\"right\" width=\"100\"\u003e\u003c/a\u003e\n\n# Aplus Framework App Project\n\n- [Home](https://aplus-framework.com/packages/app)\n- [User Guide](https://docs.aplus-framework.com/guides/projects/app/index.html)\n- [API Documentation](https://docs.aplus-framework.com/packages/app.html)\n- [Online Demo](https://demo.aplus-framework.com)\n\n[![tests](https://github.com/aplus-framework/app/actions/workflows/tests.yml/badge.svg)](https://github.com/aplus-framework/app/actions/workflows/tests.yml)\n[![coverage](https://coveralls.io/repos/github/aplus-framework/app/badge.svg?branch=master)](https://coveralls.io/github/aplus-framework/app?branch=master)\n[![packagist](https://img.shields.io/packagist/v/aplus/app)](https://packagist.org/packages/aplus/app)\n[![open-source](https://img.shields.io/badge/open--source-sponsor-magenta)](https://aplus-framework.com/sponsor)\n\n## Getting Started\n\nMake sure you have [Composer](https://getcomposer.org/doc/00-intro.md) installed.\n\nFollow the installation instructions in the [User Guide](https://docs.aplus-framework.com/guides/projects/app/index.html).\n\nTo install the latest version:\n\n```\ncomposer create-project aplus/app\n```\n\nOr, to install the latest [LTS](https://aplus-framework.com/lts) version:\n\n```\ncomposer create-project aplus/app:^24\n```\n\nEnter the project directory.\n\n---\n\nOptionally, you can start a new project on GitHub from [this template](https://github.com/new?template_name=app\u0026template_owner=aplus-framework).\n\n## Licensing\n\nAdd a `LICENSE` file.\n\nIf you think about open-source your project,\n[choose a license](https://choosealicense.com/licenses/).\n\nIf your project is proprietary, you can add your custom license or\n[not](https://choosealicense.com/no-permission/).\n\nEdit the `.php-cs-fixer.dist.php` file.\nSet the project name and copyright information.\n\nTo update the comment header in all PHP files, run:\n\n```\nvendor/bin/php-cs-fixer fix -vvv\n```\n\n## Code Quality\n\nAplus Framework uses Code Quality Tools in all its projects.\n\nBy default, App Project also uses the following tools as dev-dependencies:\n\n- [PHP-CS-Fixer](https://cs.symfony.com)\n- [phpDocumentor](https://phpdoc.org)\n- [PHPMD](https://phpmd.org)\n- [PHPStan](https://phpstan.org)\n- [PHPUnit](https://phpunit.de)\n\n### Static Analysis\n\nYou can find bugs in your code without writing tests by running:\n\n```\nvendor/bin/phpstan analyse\n```\n\nSee the `phpstan.neon.dist` file for more details.\n\n### Mess Detector\n\nYou can look for several potential problems in the source code by running:\n\n```\nvendor/bin/phpmd app xml phpmd.xml\n```\n\nCustomize your rules in the `phpmd.xml` file.\n\n### Coding Standard\n\nWe extend PHP-CS-Fixer to create the\n[Coding Standard Library](https://github.com/aplus-framework/coding-standard).\n\nIt is [PSR-12](https://www.php-fig.org/psr/psr-12/) compatible.\n\nYou can see what to fix in the source code by running:\n\n```\nvendor/bin/php-cs-fixer fix --diff --dry-run --verbose\n```\n\n### Testing\n\nWe extend PHPUnit to create the\n[Testing Library](https://github.com/aplus-framework/testing).\n\nYou can unit test your code by running:\n\n```\nvendor/bin/phpunit\n```\n\nSee the `phpunit.xml.dist` file for more details.\n\n### Documenting\n\nGood software usually has good documentation.\n\nYou can build beautiful HTML pages about your project's documentation.\n\nYou must have phpDocumentor installed on your computer or run `phpdoc`\n[inside a container](#containers).\n\n## Development Environment\n\nThe App Project is delivered with a dev-dependency to easily configure the\nbuilt-in PHP development server.\n\nJust run\n\n```\nvendor/bin/php-server\n```\n\nand your project will be available at http://localhost:8080.\n\nSee the `php-server.ini` file for more details.\n\n### Containers\n\nAplus has Docker [images](https://gitlab.com/aplus-framework/images) for testing\nand building software.\n\nYou can run it in CI or local environments.\n\nWith [Docker](https://www.docker.com/get-started) installed on your computer,\nyou can run:\n\n```\ndocker-compose run --service-ports lempa\n```\n\nThis will log you as the **developer** user into a Docker container where you can\nrun all your tests.\n\nBy default, the web app will be available at http://localhost, on ports 80 and 443.\n\nSee the `docker-compose.yml` file for more details.\n\n## Continuous Integration\n\nApp Project is cross-platform and can be used in public and private projects.\n\nYou can use it on [GitLab](https://about.gitlab.com/stages-devops-lifecycle/continuous-integration/),\non [GitHub](https://docs.github.com/en/actions/automating-builds-and-tests/about-continuous-integration),\non your computer, anywhere you want.\n\nThe App Project is already pre-configured to run in a GitLab CI environment.\n\nSee the `.gitlab-ci.yml` file for more details.\n\nJust upload your project to GitLab and it will run\n[pipelines](https://docs.gitlab.com/ee/ci/pipelines/#view-pipelines).\n\nOn GitHub, it will run [workflows](https://docs.github.com/en/actions) to test\nyour code every Push or Pull Request.\n\nCheck the `.github` folder to see more.\n\n## And now?\n\nGo build an API or a website, an awesome app! ⚡\n\nSee you.\n\n---\n\nIf you have a little time...\n\nVisit the Aplus Framework website: [aplus-framework.com](https://aplus-framework.com)\n\nFollow Aplus on:\n\n- [GitHub](https://github.com/aplus-framework)\n- [X](https://x.com/AplusFramework)\n- [Facebook](https://www.facebook.com/AplusFramework)\n- [YouTube](https://www.youtube.com/@AplusFramework)\n\nStay tuned for our updates.\n\nShare your experiences about meet us!\n\n**Remember**:\n\n\u003e Coding is Art.\n\u003e\n\u003e Coding is Engineering.\n\u003e\n\u003e Good developer loves to code.\n\u003e\n\u003e **Code with Love!**\n\n---\n\nThe Aplus Framework Team\n","funding_links":["https://github.com/sponsors/natanfelles","https://liberapay.com/aplus-framework","https://aplus-framework.com/sponsor"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faplus-framework%2Fapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faplus-framework%2Fapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faplus-framework%2Fapp/lists"}