{"id":50938323,"url":"https://github.com/oliverthiele/developer-guidelines","last_synced_at":"2026-06-17T11:30:53.897Z","repository":{"id":362561871,"uuid":"1259669963","full_name":"oliverthiele/developer-guidelines","owner":"oliverthiele","description":"Opinionated coding guidelines for PHP/TYPO3 and frontend development. Covers naming conventions, formatting, Git workflow, SCSS, JavaScript, Vue, XLIFF, and documentation standards. Used as AI assistant context and developer reference.","archived":false,"fork":false,"pushed_at":"2026-06-11T20:52:31.000Z","size":78,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T22:20:24.580Z","etag":null,"topics":["coding-guidelines","developer-guidelines","javascript","php","playwright","scss","typo3"],"latest_commit_sha":null,"homepage":"","language":null,"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/oliverthiele.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":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":"2026-06-04T18:34:23.000Z","updated_at":"2026-06-11T20:52:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/oliverthiele/developer-guidelines","commit_stats":null,"previous_names":["oliverthiele/developer-guidelines"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/oliverthiele/developer-guidelines","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oliverthiele%2Fdeveloper-guidelines","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oliverthiele%2Fdeveloper-guidelines/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oliverthiele%2Fdeveloper-guidelines/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oliverthiele%2Fdeveloper-guidelines/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oliverthiele","download_url":"https://codeload.github.com/oliverthiele/developer-guidelines/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oliverthiele%2Fdeveloper-guidelines/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34447264,"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-17T02:00:05.408Z","response_time":127,"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":["coding-guidelines","developer-guidelines","javascript","php","playwright","scss","typo3"],"created_at":"2026-06-17T11:30:50.369Z","updated_at":"2026-06-17T11:30:53.890Z","avatar_url":"https://github.com/oliverthiele.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Oliver Thiele — Developer Guidelines\n\nPersonal coding guidelines for PHP/TYPO3 projects.\n\nPublished primarily for developers who collaborate with me on projects — the\nrules\nhere reflect how I structure, name, and maintain code across all my work.\n\n---\n\n## Contents\n\n### `guidelines/`\n\nTechnology- and topic-specific coding guidelines that apply to **all projects**.\n\n| File                                                          | Topics                                                                  |\n|---------------------------------------------------------------|-------------------------------------------------------------------------|\n| [xliff.md](guidelines/xliff.md)                               | XLIFF 1.2 / 2.0 file format, attributes, source/translation conventions |\n| [typo3-developer.md](guidelines/typo3-developer.md)           | TCA, Doctrine DBAL, Fluid — universal + links to version files          |\n| [typo3-integrator.md](guidelines/typo3-integrator.md)         | TypoScript, translations — universal + links to version files           |\n| [typo3/v13/developer.md](guidelines/typo3/v13/developer.md)   | v13-specific: Fluid 4 argument types                                    |\n| [typo3/v13/integrator.md](guidelines/typo3/v13/integrator.md) | v13-specific: SiteSets, labels.xlf key naming                           |\n| [typo3/v14/developer.md](guidelines/typo3/v14/developer.md)   | v14-specific: Fluid 5 union types, FlexForm DS, TCA shortform           |\n| [php.md](guidelines/php.md)                                   | Naming conventions, PHPStan, PHP CS Fixer, type safety                  |\n| [testing.md](guidelines/testing.md)                           | Quality checks, execution order, PHPUnit, Playwright                    |\n| [git.md](guidelines/git.md)                                   | Branching workflow, commit messages, release process                    |\n| [scss.md](guidelines/scss.md)                                 | Bootstrap-first, prefix system, custom properties, state classes        |\n| [javascript.md](guidelines/javascript.md)                     | data-js hooks, Bootstrap JS, ID conventions, framework choice           |\n| [vue.md](guidelines/vue.md)                                   | Component syntax, script setup, state management, when to use Vue       |\n| [playwright.md](guidelines/playwright.md)                     | Playwright test patterns, visual regression, functional tests, helpers  |\n| [documentation.md](guidelines/documentation.md)               | README.md and CHANGELOG.md structure for Packagist extensions           |\n\nSee [guidelines/README.md](guidelines/README.md) for shared rules that cut\nacross\nall files (naming, formatting, tooling).\n\n### `sitekit/`\n\nArchitecture conventions specific to **SiteKit-based TYPO3 extensions** only.\nThese rules do not apply to generic TYPO3 projects.\n\n| File                                     | Topics                                                            |\n|------------------------------------------|-------------------------------------------------------------------|\n| [sitekit/sitekit.md](sitekit/sitekit.md) | Layer model, template path abstraction, content element rendering |\n\n---\n\n## How to use\n\n**As a developer working with me:**\nLoad the relevant guideline file(s) for the area you are working in and follow\nthe\nrules as written. When in doubt, prefer the existing project pattern over\nintroducing\na new one.\n\n**As an AI assistant:**\nLoad only the files relevant to the current task. Follow rules strictly — do not\nreinterpret or override them based on general conventions. The guidelines take\nprecedence over defaults.\n\n---\n\n## License\n\nThese guidelines are published for reference and collaboration. Feel free to\nadapt\nthem for your own projects.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foliverthiele%2Fdeveloper-guidelines","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foliverthiele%2Fdeveloper-guidelines","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foliverthiele%2Fdeveloper-guidelines/lists"}