{"id":14965487,"url":"https://github.com/matronator/starterpack","last_synced_at":"2025-10-25T11:32:03.319Z","repository":{"id":55051283,"uuid":"326001683","full_name":"matronator/starterpack","owner":"matronator","description":"Starter template for Nette projects with custom CMS","archived":false,"fork":false,"pushed_at":"2025-01-23T15:56:44.000Z","size":2616,"stargazers_count":1,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-01-31T07:05:12.063Z","etag":null,"topics":["cms","cms-framework","content-management-system","nette","nette-cms","nette-framework","starter","starter-project"],"latest_commit_sha":null,"homepage":"https://cms.matronator.com","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/matronator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"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},"funding":{"github":["matronator"],"patreon":"matronator","open_collective":null,"ko_fi":"matronator","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.paypal.me/matronator","https://www.blockchain.com/btc/address/35VRpVQaqFWjUCnVRpGineShz76QyYgSVg"]}},"created_at":"2021-01-01T15:10:55.000Z","updated_at":"2024-10-19T05:33:55.000Z","dependencies_parsed_at":"2024-12-05T00:26:28.129Z","dependency_job_id":"8c68a16b-84e6-49a9-8841-b2791f92ded8","html_url":"https://github.com/matronator/starterpack","commit_stats":{"total_commits":21,"total_committers":3,"mean_commits":7.0,"dds":0.1428571428571429,"last_synced_commit":"c8efc4e7f66dabc509e004940066f1c230ed4074"},"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matronator%2Fstarterpack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matronator%2Fstarterpack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matronator%2Fstarterpack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matronator%2Fstarterpack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matronator","download_url":"https://codeload.github.com/matronator/starterpack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238128664,"owners_count":19421076,"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":["cms","cms-framework","content-management-system","nette","nette-cms","nette-framework","starter","starter-project"],"created_at":"2024-09-24T13:34:49.117Z","updated_at":"2025-10-25T11:32:02.232Z","avatar_url":"https://github.com/matronator.png","language":"PHP","funding_links":["https://github.com/sponsors/matronator","https://patreon.com/matronator","https://ko-fi.com/matronator","https://www.paypal.me/matronator","https://www.blockchain.com/btc/address/35VRpVQaqFWjUCnVRpGineShz76QyYgSVg"],"categories":[],"sub_categories":[],"readme":"# How to start a project:\n\n## Install dependencies\n\nRun `composer install` and `npm install` commands in the root folder of the project\n\n## Prepare the data layer\n\nCreate database and run SQL in `/init-db.sql` or import it via database admin (phpmyadmin/adminer/...)\n\nConnect database in `/app/config/config.local.neon`. Provide database name, login and password.\n\n## Set your environment variales\n\nCreate `/.env` file and set `HOST` with URL where the project is hosted. (see [example](https://github.com/motdotla/dotenv#usage)). This step is necessary if you don't use `npm run serve`. Otherwise, you can go with the defaults.\n\n# Build process\nThere are two basic modules - front and admin. Use `./dev` and its respective subfolders to create or edit front-end assets. Here is an example of the folder structure:\n\n\n```\n/dev\n|-- admin\n|   |-- (same structure as front)\n`-- front\n    |-- images\n    |      |-- photo.jpg\n    |      `-- chart.png\n    |-- icons\n    |      |-- mail.svg\n    |      `-- arrow.svg\n    |-- css\n    |   |-- index.js\n    |   `-- contact.js\n    |-- js\n    |   |-- index.css\n    |   `-- contact.css\n    `-- etc\n```\n\nAll assets are compiled into `/www/dist` folder. For every module subfolder with its name is created.\n\nKeep in mind that files in `images` and `etc` preserve their original directory. Other files (css, js, icons) are generated into the root. For example in `app/components/Hamburger/Hamburger.css` you should reference external images as follows:\n\n```css\n.hamburger {\n    background-image: url(images/hamburger.svg);\n}\n```\n\n## Development\n\nRun `npm start` if you want to develop the front module. For the admin module use `npm run start-admin` command.\n\nWhenever a file (except `etc/*`) in `/dev` folder or template is changed, the web server will automatically refresh your browser window.\n\n### Admin module\n\nThe `init-db.sql` file imports one default user with admin rights that you can use to login to the administration. You can change it or create a new one in the administration on the Users page.\n\nE-mail: `info@matronator.com`\n\nPassword: `changeme`\n\n**DON'T FORGET TO CHANGE THE CREDENTIALS BEFORE DEPLOYING ON PRODUCTION!**\n\n## Production\n\nRun `npm run build` if you want to create production build of the front module. For the admin module use `npm run build-admin` command.\n\n# Asset usage\n\nBecause of cache busting, the only way of using your assets is by means of `{asset}` custom Latte macro. It accepts two parameters. First is an asset name and the second is a module name (front or admin).\n\nExamples:\n\n```html\n\u003cscript src=\"{asset index.js front}\"\u003e\u003c/script\u003e\n...\n\u003clink rel=\"stylesheet\" href=\"{asset panel.css admin}\" \u003e\n```\n\nCurrently, the macro doesn't take `$baseUrl` into account, so **the server must host to the domain root**\n\n# Coding standard\n\n## Javascript\n\nFormatting is handled by [Prettier](https://prettier.io/). Standard is enforced by [ESLint](https://eslint.org/) rules (see `eslintConfig.rules` in `package.json` for a reference).\n\n## CSS\n\nFormatting is handled by [Prettier](https://prettier.io/). Standard is enforced by [Stylelint](https://stylelint.io/) rules (see `stylelint.rules` in `package.json` for a reference).\n\n## PHP\n\nWIP\n\n# GIT\n\nAll commit messages must be written in English in present tense.\n\nRun `npm run lint-css` and `npm run lint-js` before you commit to check if your code adheres to the coding standard. It automatically fixes problems with formatting. Issues which cannot be solved automatically are displayed to the console.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatronator%2Fstarterpack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatronator%2Fstarterpack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatronator%2Fstarterpack/lists"}