{"id":21029885,"url":"https://github.com/kitconcept/kitconcept.blog","last_synced_at":"2026-03-19T18:31:32.035Z","repository":{"id":205954854,"uuid":"710678015","full_name":"kitconcept/kitconcept.blog","owner":"kitconcept","description":null,"archived":false,"fork":false,"pushed_at":"2023-11-07T19:21:53.000Z","size":1792,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-18T08:27:05.815Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Makefile","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}},"created_at":"2023-10-27T07:51:21.000Z","updated_at":"2023-10-27T09:11:54.000Z","dependencies_parsed_at":"2024-11-19T12:15:21.612Z","dependency_job_id":"d6413f3a-73b2-4bdc-99cd-906af2efec43","html_url":"https://github.com/kitconcept/kitconcept.blog","commit_stats":null,"previous_names":["kitconcept/kitconcept.blog"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kitconcept/kitconcept.blog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept.blog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept.blog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept.blog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept.blog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kitconcept","download_url":"https://codeload.github.com/kitconcept/kitconcept.blog/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitconcept%2Fkitconcept.blog/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265892102,"owners_count":23844967,"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":[],"created_at":"2024-11-19T12:14:53.679Z","updated_at":"2026-03-19T18:31:26.999Z","avatar_url":"https://github.com/kitconcept.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kitconcept.blog 🚀\n\n[![Built with Cookiecutter Plone Starter](https://img.shields.io/badge/built%20with-Cookiecutter%20Plone%20Starter-0083be.svg?logo=cookiecutter)](https://github.com/collective/cookiecutter-plone-starter/)\n[![Black code style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)\n[![Backend Tests](https://github.com/kitconcept/kitconcept-blog/actions/workflows/backend.yml/badge.svg)](https://github.com/kitconcept/kitconcept-blog/actions/workflows/backend.yml)\n[![Frontend Tests](https://github.com/kitconcept/kitconcept-blog/actions/workflows/frontend.yml/badge.svg)](https://github.com/kitconcept/kitconcept-blog/actions/workflows/frontend.yml)\n\nA new project using Plone 6.\n\n## Quick Start 🏁\n\n### Prerequisites ✅\n\nEnsure you have the following installed:\n\n- Python 3.11 🐍\n- Node 18 🟩\n- yarn 🧶\n- Docker 🐳\n\n### Installation 🔧\n\n1. Clone the repository:\n\n```shell\ngit clone git@github.com:kitconcept/kitconcept-blog.git\ncd kitconcept-blog\n```\n\n2. Install both Backend and Frontend:\n\n```shell\nmake install\n```\n\n### Fire Up the Servers 🔥\n\n1. Create a new Plone site on your first run:\n\n```shell\nmake create-site\n```\n\n2. Start the Backend at [http://localhost:8080/](http://localhost:8080/):\n\n```shell\nmake start-backend\n```\n\n3. In a new terminal, start the Frontend at [http://localhost:3000/](http://localhost:3000/):\n\n```shell\nmake start-frontend\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-blog.localhost](http://kitconcept-blog.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 three distinct sections: `backend`, `frontend`, and `devops`.\n\n- **backend**: Houses the API and Plone installation, utilizing pip instead of buildout, and includes a policy package named kitconcept_blog.\n- **frontend**: Contains the React (Volto) package.\n- **devops**: Encompasses Docker Stack and Ansible playbooks.\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 format\n```\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\nCrafted with care by **This was generated by [cookiecutter-plone-starter](https://github.com/collective/cookiecutter-plone-starter) on 2023-10-27 09:04:19**. A special thanks to all contributors and supporters!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkitconcept%2Fkitconcept.blog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkitconcept%2Fkitconcept.blog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkitconcept%2Fkitconcept.blog/lists"}