{"id":13607392,"url":"https://github.com/wintercms/web-installer","last_synced_at":"2025-05-13T16:31:39.382Z","repository":{"id":49049883,"uuid":"361320322","full_name":"wintercms/web-installer","owner":"wintercms","description":"Web-based installer for Winter CMS","archived":false,"fork":false,"pushed_at":"2024-10-03T02:18:46.000Z","size":3174,"stargazers_count":29,"open_issues_count":8,"forks_count":4,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-27T12:39:10.501Z","etag":null,"topics":["hacktoberfest","installer","php","vue","wintercms"],"latest_commit_sha":null,"homepage":"https://wintercms.com/","language":"Vue","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/wintercms.png","metadata":{"funding":{"github":"wintercms","open_collective":"wintercms"},"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2021-04-25T03:17:52.000Z","updated_at":"2025-01-02T03:28:01.000Z","dependencies_parsed_at":"2024-01-05T05:02:25.192Z","dependency_job_id":"6cb1b1e8-fc41-492e-a3f4-cc29211e3c22","html_url":"https://github.com/wintercms/web-installer","commit_stats":{"total_commits":120,"total_committers":4,"mean_commits":30.0,"dds":0.04166666666666663,"last_synced_commit":"3da8246eac590ee82f1095f922ba42cc5e7d516d"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wintercms%2Fweb-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wintercms%2Fweb-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wintercms%2Fweb-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wintercms%2Fweb-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wintercms","download_url":"https://codeload.github.com/wintercms/web-installer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252789040,"owners_count":21804375,"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":["hacktoberfest","installer","php","vue","wintercms"],"created_at":"2024-08-01T19:01:18.274Z","updated_at":"2025-05-13T16:31:38.529Z","avatar_url":"https://github.com/wintercms.png","language":"Vue","funding_links":["https://github.com/sponsors/wintercms","https://opencollective.com/wintercms"],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# Winter CMS Web Installer\n\n[![Discord](https://img.shields.io/discord/816852513684193281?label=discord\u0026style=flat-square)](https://discord.gg/D5MFSPH6Ux)\n\n![Web Installer Preview](https://raw.githubusercontent.com/wintercms/web-installer/main/.github/web-installer.jpg)\n\nA web-based installation script that will install a fresh copy of Winter CMS. This is the recommended method of installation for **non-technical users**. It is simpler than the command-line installation or Composer methods and does not require any special skills.\n\nFor developers, we recommend the following methods:\n\n- [Composer installation](https://wintercms.com/docs/v1.2/docs/architecture/using-composer#installing-winter-via-composer)\n- [Command-line installation](https://github.com/wintercms/cli)\n\n## Installation\n\n\u003e **NOTE:** This installer installs Winter CMS 1.2, which requires PHP 8.0 or above. If you are still running PHP 7.4 or below, please use [v1.0.2](https://github.com/wintercms/web-installer/releases/download/v1.0.2/install.zip) of this installer, which installs Winter 1.1. Do note that this branch of Winter is now end-of-life and will only be receiving security fixes.\n\n1. Prepare an empty directory on the web server that will host your Winter CMS installation. It can be a main domain, sub-domain or subfolder.\n2. [Download the latest \"install.zip\" file](https://github.com/wintercms/web-installer/releases/latest/download/install.zip) into this folder.\n3. Unzip the downloaded ZIP file.\n4. Grant write permissions to all files and folders that were extracted.\n5. In your web browser, navigate to the URL pointing to that folder, and include `/install.html` at the end of the URL.\n6. Follow the instructions given in the installer.\n\n## Links\n\nFor further information and requirements for Winter CMS, [consult the documentation](https://wintercms.com/docs). To review the files that will be installed, visit the [main Winter CMS repository](https://github.com/wintercms/winter).\n\n## Development\n\nThe Web installer is built on [VueJS](https://vuejs.org) and uses a primarily NodeJS-driven development pipeline, but does\ncontain a PHP API element to run checks on the system and perform the installation of Winter CMS. You will need the following:\n\n- `node` v14 or above.\n- `npm` v6 or above.\n- `php` v8.0 or above\n\nTo install all necessary dependencies, run the following:\n\n```\nnpm install\n```\n\nYou will also need to install the PHP dependencies located in the `public/install/api` directory. Run the following from the root directory to do so:\n\n```\ncomposer --working-dir=./public/install/api install\n```\n\n\n### Development server (hot-reloading)\n\nThe included dependencies include a simple web-server which performs hot-reloading of the app when changes are made. To start this server, run the following:\n\n```\nnpm run dev\n```\n\nYou will be given a URL in which you can review the application in your browser.\n\nWhen developing in this format, you will need to provide a URL in order to access the PHP API file located in `public/install/api.php`. You will need to create a file called `.env.local` inside the root folder of your development copy, and add the following line:\n\n```\nVITE_APP_INSTALL_URL=\"\u003cpath\u003e\"\n```\n\nSubstituting `\u003cpath\u003e` with the URL to the `public/install` directory as it would be located on your web server. You can run the in-built PHP server to serve this, by navigating to this folder and running the following command:\n\n```\nphp -S 127.0.0.1:8081\n```\n\nIn following the above, the `.env.local` file should contain the following:\n\n```\nVITE_APP_INSTALL_URL=\"http://127.0.0.1:8081\"\n```\n\n### Building the application\n\nBuilding the application is a piece of cake! Simply run the following:\n\n```\nnpm run build\n```\n\nThe build will then be made available in the `dist` subfolder.\n\n### Linting\n\nThis application is built on a strict code formatting and quality standard, and will be checked on commit. If you want to fix common issues and check that your code meets the standard, you can run the following:\n\n```\nnpm run lint\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwintercms%2Fweb-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwintercms%2Fweb-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwintercms%2Fweb-installer/lists"}