PHPackages                             boardflow/boardflow-core - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. boardflow/boardflow-core

ActiveLibrary[Utility & Helpers](/categories/utility)

boardflow/boardflow-core
========================

Framework-agnostic PHP chess core for move validation, game state management, FEN/PGN handling, and engine integration.

00

Since Apr 11Pushed 3mo agoCompare

[ Source](https://github.com/vwinck-dev/boardflow-core)[ Packagist](https://packagist.org/packages/boardflow/boardflow-core)[ RSS](/packages/boardflow-boardflow-core/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Boardflow Core ♟️
=================

[](#boardflow-core-️)

> ⚠️ **Version v0.0.0 — Work in Progress (WIP)**
>
> This package is currently under active development. Breaking changes are expected and the API is not stable yet.

---

📦 About
-------

[](#-about)

**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.

The 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.

---

🎯 Scope
-------

[](#-scope)

This package is responsible for:

- ♟️ Chess board representation
- ♜ Piece modeling (types, colors, movement rules)
- ✅ Move validation (legal moves, illegal moves, edge cases)
- 🔁 Game state management (turns, history, undo/redo)
- 👑 Special rules:
    - Castling
    - En passant
    - Promotion
- ⚠️ Game conditions:
    - Check
    - Checkmate
    - Stalemate
    - Draw detection
- 📄 FEN parsing and generation
- 📜 PGN parsing and export

---

🚫 Out of Scope
--------------

[](#-out-of-scope)

This package deliberately does **not** include:

- ❌ UI / rendering
- ❌ Laravel integration
- ❌ Chess engine (Stockfish, etc.)
- ❌ Networking / multiplayer

---

🔌 Engine Integration (Future-Proof)
-----------------------------------

[](#-engine-integration-future-proof)

Boardflow Core is designed to work with **pluggable chess engines** via abstraction.

This allows integration with:

- Local engines (e.g. Stockfish via CLI, but to be analysed)
- Remote APIs
- Custom engines (e.g. future `boardflow-engine`)

---

🧱 Philosophy
------------

[](#-philosophy)

- Pure PHP, no framework dependencies
- Strict typing and modern PHP (8.2+)
- Decoupled and testable architecture
- Designed for reuse across multiple environments

---

🛠️ Status
---------

[](#️-status)

🚧 This project is in early development.

Things that may change:

- Public API
- Class structure
- Naming conventions
- Actually... Everything :D

---

📚 Roadmap (Initial, to be discussed)
------------------------------------

[](#-roadmap-initial-to-be-discussed)

- Board representation
- Piece system
- Move validation engine
- FEN support
- PGN support
- Game state manager
- Engine interface abstraction

---

🤝 Contributing
--------------

[](#-contributing)

Not open for contributions yet — the architecture is still being defined.

---

📄 License
---------

[](#-license)

MIT

###  Health Score

18

—

LowBetter than 7% of packages

Maintenance54

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/176328088?v=4)[V. Winck](/maintainers/vwinck-dev)[@vwinck-dev](https://github.com/vwinck-dev)

---

Top Contributors

[![vwinck-dev](https://avatars.githubusercontent.com/u/176328088?v=4)](https://github.com/vwinck-dev "vwinck-dev (1 commits)")

---

Tags

board-game-frameworkboardflowboardflow-corechesscoreenginefenpgnpgn-analyzerpgn-parserpgn-readerpgn-viewer

### Embed Badge

![Health badge](/badges/boardflow-boardflow-core/health.svg)

```
[![Health](https://phpackages.com/badges/boardflow-boardflow-core/health.svg)](https://phpackages.com/packages/boardflow-boardflow-core)
```

###  Alternatives

[jetbrains/phpstorm-stubs

PHP runtime & extensions header files for PhpStorm

1.4k32.7M84](/packages/jetbrains-phpstorm-stubs)[localheinz/diff

Fork of sebastian/diff for use with ergebnis/composer-normalize

4741.1M9](/packages/localheinz-diff)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)