Synhex
A simultaneous-turn hex tactics game (Frozen Synapse–inspired) with friends, invitation links, rematches, personal avatars and SQLite storage. Seeded from Microchess's match/lobby shell.
The complete application is in web/. Files outside that folder are for repository tooling and CI only. Start locally:
php -S 127.0.0.1:8080 -t web web/router.php
Localhost automatically uses a test account. See web/README.md for setup, OAuth (auth.timfalken.com), rules and tests.
Game balance knobs (accuracy, weapons, walk range, grid size, walls, vision) live in one file: web/lib/game-config.php. OAuth secrets stay in the generated, gitignored web/data/config.php.
This branch is the seed for a future GitLab project Timfa/synhex. Production FTP deploy is disabled until that host exists.
GitLab CI/CD
The default branch is master. .gitlab-ci.yml runs PHP/hex/API tests, JavaScript checks and a real FTP fixture test. The ftp_upload deploy job is set to when: never so pipelines never upload. Re-enable it when production exists.
Required CI variables (unused until deploy is turned back on):
| Variable | Value |
|---|---|
timftphost | FTP/FTPS/SFTP hostname or URL |
timftpuser | Login name |
timftppassword | Password; configure as masked/protected in GitLab |
projectftp | Existing remote application directory, relative to the FTP login root or absolute |
The mirror preserves the entire production data/ directory. Test artifacts, the development router and the application README are excluded from upload.
The deployment fixture can also run locally with Python 3, pyftpdlib and lftp:
python3 ci/test_deploy.py
Source
| 1 | # Synhex |
| 2 | |
| 3 | A simultaneous-turn hex tactics game (Frozen Synapse–inspired) with friends, invitation links, rematches, personal avatars and SQLite storage. Seeded from Microchess's match/lobby shell. |
| 4 | |
| 5 | The complete application is in [`web/`](web/). Files outside that folder are for repository tooling and CI only. Start locally: |
| 6 | |
| 7 | ```sh |
| 8 | php -S 127.0.0.1:8080 -t web web/router.php |
| 9 | ``` |
| 10 | |
| 11 | Localhost automatically uses a test account. See [`web/README.md`](web/README.md) for setup, OAuth (`auth.timfalken.com`), rules and tests. |
| 12 | |
| 13 | Game balance knobs (accuracy, weapons, walk range, grid size, walls, vision) live in one file: [`web/lib/game-config.php`](web/lib/game-config.php). OAuth secrets stay in the generated, gitignored `web/data/config.php`. |
| 14 | |
| 15 | This branch is the seed for a future GitLab project `Timfa/synhex`. **Production FTP deploy is disabled** until that host exists. |
| 16 | |
| 17 | ## GitLab CI/CD |
| 18 | |
| 19 | The default branch is `master`. `.gitlab-ci.yml` runs PHP/hex/API tests, JavaScript checks and a real FTP fixture test. The `ftp_upload` deploy job is set to `when: never` so pipelines never upload. Re-enable it when production exists. |
| 20 | |
| 21 | Required CI variables (unused until deploy is turned back on): |
| 22 | |
| 23 | | Variable | Value | |
| 24 | | --- | --- | |
| 25 | | `timftphost` | FTP/FTPS/SFTP hostname or URL | |
| 26 | | `timftpuser` | Login name | |
| 27 | | `timftppassword` | Password; configure as masked/protected in GitLab | |
| 28 | | `projectftp` | Existing remote application directory, relative to the FTP login root or absolute | |
| 29 | |
| 30 | The mirror preserves the entire production `data/` directory. Test artifacts, the development router and the application README are excluded from upload. |
| 31 | |
| 32 | The deployment fixture can also run locally with Python 3, `pyftpdlib` and `lftp`: |
| 33 | |
| 34 | ```sh |
| 35 | python3 ci/test_deploy.py |
| 36 | ``` |