{"id":37617863,"url":"https://github.com/kitconcept/kitconcept-core","last_synced_at":"2026-06-15T12:01:45.489Z","repository":{"id":290431074,"uuid":"974390117","full_name":"kitconcept/kitconcept-core","owner":"kitconcept","description":"Core setup for kitconcept GmbH distributions built on top of Plone","archived":false,"fork":false,"pushed_at":"2026-06-08T09:28:47.000Z","size":4351,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-08T11:19:07.094Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://kitconcept-core.readthedocs.io/","language":"Python","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/kitconcept.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-28T17:46:54.000Z","updated_at":"2026-05-15T11:22:09.000Z","dependencies_parsed_at":"2026-03-18T16:06:09.270Z","dependency_job_id":null,"html_url":"https://github.com/kitconcept/kitconcept-core","commit_stats":null,"previous_names":["kitconcept/kitconcept-core"],"tags_count":96,"template":false,"template_full_name":null,"purl":"pkg:github/kitconcept/kitconcept-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kitconcept","download_url":"https://codeload.github.com/kitconcept/kitconcept-core/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept-core/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34361403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-01-16T10:34:08.340Z","updated_at":"2026-06-15T12:01:45.484Z","avatar_url":"https://github.com/kitconcept.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kitconcept.core 🚀\n\n[![Built with Cookieplone](https://img.shields.io/badge/built%20with-Cookieplone-0083be.svg?logo=cookiecutter)](https://github.com/plone/cookieplone-templates/)\n[![CI](https://github.com/kitconcept/kitconcept-core/actions/workflows/main.yml/badge.svg)](https://github.com/kitconcept/kitconcept-core/actions/workflows/main.yml)\n\nCore setup for kitconcept GmbH distributions built on top of Plone\n\n## Quick Start 🏁\n\n### Prerequisites ✅\n\n-   An [operating system](https://6.docs.plone.org/install/create-project-cookieplone.html#prerequisites-for-installation) that runs all the requirements mentioned.\n-   [uv](https://6.docs.plone.org/install/create-project-cookieplone.html#uv)\n-   [nvm](https://6.docs.plone.org/install/create-project-cookieplone.html#nvm)\n-   [Node.js and pnpm](https://6.docs.plone.org/install/create-project.html#node-js) 22\n-   [Make](https://6.docs.plone.org/install/create-project-cookieplone.html#make)\n-   [Git](https://6.docs.plone.org/install/create-project-cookieplone.html#git)\n-   [Docker](https://docs.docker.com/get-started/get-docker/) (optional)\n\n\n### Installation 🔧\n\n1.  Clone this repository, then change your working directory.\n\n    ```shell\n    git clone git@github.com:kitconcept/kitconcept-core.git\n    cd kitconcept-core\n    ```\n\n2.  Install this code base.\n\n    ```shell\n    make install\n    ```\n\n\n### Fire Up the Servers 🔥\n\n1.  Create a new Plone site on your first run.\n\n    ```shell\n    make backend-create-site\n    ```\n\n2.  Start the backend at http://localhost:8080/.\n\n    ```shell\n    make backend-start\n    ```\n\n3.  In a new shell session, start the frontend at http://localhost:3000/.\n\n    ```shell\n    make frontend-start\n    ```\n\nVoila! Your Plone site should be live and kicking! 🎉\n\n### Local Stack Deployment 📦\n\nDeploy a local `Docker Compose` environment that includes:\n\n- Docker images for Backend and Frontend 🖼️\n- A stack with a Traefik router and a Postgres database 🗃️\n- Accessible at [http://kitconcept-core.localhost](http://kitconcept-core.localhost) 🌐\n\nExecute the following:\n\n```shell\nmake stack-start\nmake stack-create-site\n```\n\nAnd... you're all set! Your Plone site is up and running locally! 🚀\n\n## Project Structure 🏗️\n\nThis monorepo consists of the following distinct sections:\n\n- **backend**: Houses the API and Plone installation, utilizing pip instead of buildout, and includes a policy package named kitconcept.core.\n- **frontend**: Contains the React (Volto) package.\n- **devops**: Encompasses Docker Stack, Ansible playbooks, and Cache settings.\n- **docs**: Scaffold for writing documentation for your project.\n\n### Why This Structure? 🤔\n\n- All necessary codebases to run the site are contained within the repo (excluding existing addons for Plone and React).\n- Specific GitHub Workflows are triggered based on changes in each codebase (refer to .github/workflows).\n- Simplifies the creation of Docker images for each codebase.\n- Demonstrates Plone installation/setup without buildout.\n\n## Code Quality Assurance 🧐\n\nTo automatically format your code and ensure it adheres to quality standards, execute:\n\n```shell\nmake check\n```\n\n### Format the codebase\n\nTo format the codebase, it is possible to run `format`:\n\n```shell\nmake format\n```\n\n| Section | Tool | Description | Configuration |\n| --- | --- | --- | --- |\n| backend | Ruff | Python code formatting, imports sorting  | [`backend/pyproject.toml`](./backend/pyproject.toml) |\n| backend | `zpretty` | XML and ZCML formatting  | -- |\n| frontend | ESLint | Fixes most common frontend issues | [`frontend/.eslintrc.js`](.frontend/.eslintrc.js) |\n| frontend | prettier | Format JS and Typescript code  | [`frontend/.prettierrc`](.frontend/.prettierrc) |\n| frontend | Stylelint | Format Styles (css, less, sass)  | [`frontend/.stylelintrc`](.frontend/.stylelintrc) |\n\nFormatters can also be run within the `backend` or `frontend` folders.\n\n### Linting the codebase\nor `lint`:\n\n ```shell\nmake lint\n```\n\n| Section | Tool | Description | Configuration |\n| --- | --- | --- | --- |\n| backend | Ruff | Checks code formatting, imports sorting  | [`backend/pyproject.toml`](./backend/pyproject.toml) |\n| backend | Pyroma | Checks Python package metadata  | -- |\n| backend | check-python-versions | Checks Python version information  | -- |\n| backend | `zpretty` | Checks XML and ZCML formatting  | -- |\n| frontend | ESLint | Checks JS / Typescript lint | [`frontend/.eslintrc.js`](.frontend/.eslintrc.js) |\n| frontend | prettier | Check JS / Typescript formatting  | [`frontend/.prettierrc`](.frontend/.prettierrc) |\n| frontend | Stylelint | Check Styles (css, less, sass) formatting  | [`frontend/.stylelintrc`](.frontend/.stylelintrc) |\n\nLinters can be run individually within the `backend` or `frontend` folders.\n\n## Internationalization 🌐\n\nGenerate translation files for Plone and Volto with ease:\n\n```shell\nmake i18n\n```\n\n## Credits and Acknowledgements 🙏\n\nGenerated using [Cookieplone (0.9.7)](https://github.com/plone/cookieplone) and [cookieplone-templates (0beeb9f)](https://github.com/plone/cookieplone-templates/commit/0beeb9f07d04cdd732c487422c94ed975b73507d) on 2025-04-28 11:48:40.459239. A special thanks to all contributors and supporters!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkitconcept%2Fkitconcept-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkitconcept%2Fkitconcept-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkitconcept%2Fkitconcept-core/lists"}