{"id":51307152,"url":"https://github.com/vwinck-dev/boardflow-core","last_synced_at":"2026-07-01T00:41:46.930Z","repository":{"id":350591634,"uuid":"1207480966","full_name":"vwinck-dev/boardflow-core","owner":"vwinck-dev","description":"A framework-agnostic PHP chess core focused on move validation, game state, and extensible engine integration.","archived":false,"fork":false,"pushed_at":"2026-04-11T03:39:25.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-11T05:32:31.830Z","etag":null,"topics":["board-game-framework","boardflow","boardflow-core","chess","core","engine","fen","pgn","pgn-analyzer","pgn-parser","pgn-reader","pgn-viewer"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":false,"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/vwinck-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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-04-11T01:56:11.000Z","updated_at":"2026-04-11T03:39:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vwinck-dev/boardflow-core","commit_stats":null,"previous_names":["vwinck-dev/boardflow-core"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/vwinck-dev/boardflow-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vwinck-dev%2Fboardflow-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vwinck-dev%2Fboardflow-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vwinck-dev%2Fboardflow-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vwinck-dev%2Fboardflow-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vwinck-dev","download_url":"https://codeload.github.com/vwinck-dev/boardflow-core/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vwinck-dev%2Fboardflow-core/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34988713,"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-30T02:00:05.919Z","response_time":92,"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":["board-game-framework","boardflow","boardflow-core","chess","core","engine","fen","pgn","pgn-analyzer","pgn-parser","pgn-reader","pgn-viewer"],"created_at":"2026-07-01T00:41:46.485Z","updated_at":"2026-07-01T00:41:46.917Z","avatar_url":"https://github.com/vwinck-dev.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Boardflow Core ♟️\n\n\u003e ⚠️ **Version v0.0.0 — Work in Progress (WIP)**\n\u003e\n\u003e This package is currently under active development. Breaking changes are expected and the API is not stable yet.\n\n---\n\n## 📦 About\n\n**Boardflow Core** is the foundational package of the Boardflow ecosystem. It provides a pure PHP implementation of chess logic, completely framework-agnostic and designed for extensibility.\n\nThe goal of this package is to handle all **game rules and state management**, while remaining independent from UI layers, frameworks (like Laravel), and chess engines.\n\n---\n\n## 🎯 Scope\n\nThis package is responsible for:\n\n- ♟️ Chess board representation\n- ♜ Piece modeling (types, colors, movement rules)\n- ✅ Move validation (legal moves, illegal moves, edge cases)\n- 🔁 Game state management (turns, history, undo/redo)\n- 👑 Special rules:\n  - Castling\n  - En passant\n  - Promotion\n- ⚠️ Game conditions:\n  - Check\n  - Checkmate\n  - Stalemate\n  - Draw detection\n- 📄 FEN parsing and generation\n- 📜 PGN parsing and export\n\n---\n\n## 🚫 Out of Scope\n\nThis package deliberately does **not** include:\n\n- ❌ UI / rendering\n- ❌ Laravel integration\n- ❌ Chess engine (Stockfish, etc.)\n- ❌ Networking / multiplayer\n\n---\n\n## 🔌 Engine Integration (Future-Proof)\n\nBoardflow Core is designed to work with **pluggable chess engines** via abstraction.\n\nThis allows integration with:\n- Local engines (e.g. Stockfish via CLI, but to be analysed)\n- Remote APIs\n- Custom engines (e.g. future `boardflow-engine`)\n\n---\n\n## 🧱 Philosophy\n\n- Pure PHP, no framework dependencies\n- Strict typing and modern PHP (8.2+)\n- Decoupled and testable architecture\n- Designed for reuse across multiple environments\n\n---\n\n## 🛠️ Status\n\n🚧 This project is in early development.\n\nThings that may change:\n- Public API\n- Class structure\n- Naming conventions\n- Actually... Everything :D\n\n---\n\n## 📚 Roadmap (Initial, to be discussed)\n\n- [ ] Board representation\n- [ ] Piece system \n- [ ] Move validation engine\n- [ ] FEN support\n- [ ] PGN support\n- [ ] Game state manager\n- [ ] Engine interface abstraction\n\n---\n\n## 🤝 Contributing\n\nNot open for contributions yet — the architecture is still being defined.\n\n---\n\n## 📄 License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvwinck-dev%2Fboardflow-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvwinck-dev%2Fboardflow-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvwinck-dev%2Fboardflow-core/lists"}