Setting up BGA Development environment using VSCode - Revision history

Kenpoh: /* One time only - first sync */

2026-09-01T21:20:47Z

One time only - first sync

← Older revision		Revision as of 23:20, 1 September 2026
Line 111:		Line 111:
	After initially downloading the project, you can add _ide_helper.php to the "ignore" list. Even though it is needed locally for the IDE to understand BGA-related php code, you will never need to update it.		After initially downloading the project, you can add _ide_helper.php to the "ignore" list. Even though it is needed locally for the IDE to understand BGA-related php code, you will never need to update it.

	Please note, if you download the files and they are empty when you look at them~~. Do~~ not type anything into them until you deal with the TypeError: isDate is not a function error first. The recommended sftp extension in vscode as of 2026-09-01 has some issues with its code. Perhaps try WireFerry instead. If you type something into the files and auto sync is on, you may overwrite files on the server.		Please note, if you download the files and they are empty when you look at them, do not type anything into them until you deal with the TypeError: isDate is not a function error first. The recommended sftp extension in vscode as of 2026-09-01 has some issues with its code. Looking up the error online will lead you to fixes. Perhaps try WireFerry instead. If you type something into the files and auto sync is on, you may overwrite files on the server.

	=== Daily use===		=== Daily use===

Kenpoh: /* One time only - first sync */

2026-09-01T21:20:00Z

One time only - first sync

← Older revision		Revision as of 23:20, 1 September 2026
Line 110:		Line 110:

	After initially downloading the project, you can add _ide_helper.php to the "ignore" list. Even though it is needed locally for the IDE to understand BGA-related php code, you will never need to update it.		After initially downloading the project, you can add _ide_helper.php to the "ignore" list. Even though it is needed locally for the IDE to understand BGA-related php code, you will never need to update it.

			Please note, if you download the files and they are empty when you look at them. Do not type anything into them until you deal with the TypeError: isDate is not a function error first. The recommended sftp extension in vscode as of 2026-09-01 has some issues with its code. Perhaps try WireFerry instead. If you type something into the files and auto sync is on, you may overwrite files on the server.

	=== Daily use===		=== Daily use===

Victoria La: /* User templates */

2026-03-14T12:54:15Z

User templates

@@ Line 206: / Line 206: @@
 <pre>
+{
    "Player loop in game.php": {
      "prefix": ["players"],

Victoria La: /* PHP Intellisense */

2026-03-14T12:52:48Z

PHP Intellisense

← Older revision		Revision as of 14:52, 14 March 2026
Line 25:		Line 25:
	===PHP Intellisense===		===PHP Intellisense===

	The ~~ide_helper~~ file, included in every project, will help your IDE know the available functions of the framework. This file may be updated automatically on your FTP folder, so don't hesitate to pull it back if it misses something, it might have been updated!		The "_ide_helper.php" file, included in every project, will help your IDE know the available functions of the framework. This file may be updated automatically on your FTP folder, so don't hesitate to pull it back if it misses something, it might have been updated!

	To solve the warning about the material file class members (warning only appears if you use legacy material file)		To solve the warning about the material file class members (warning only appears if you use legacy material file)

Victoria La: /* JavaScript Intellisense */

2026-03-14T12:51:35Z

JavaScript Intellisense

← Older revision		Revision as of 14:51, 14 March 2026
Line 18:		Line 18:
	=== JavaScript Intellisense ===		=== JavaScript Intellisense ===

	* Since BGA framework ditched dojo in 2025 we can rejoice and enjoy full ide support. If try it for old dojo projects - it does not really work.		* Since BGA framework ditched dojo in 2025 we can rejoice and enjoy full ide support. If you try it for old dojo projects - it does not really work.

	* A good way to improve auto-complete and such is to use Typescript and SCSS, this is not for the beginners.		* A good way to improve auto-complete and such is to use Typescript and SCSS, this is not for the beginners.
	** Original wiki: https://en.doc.boardgamearena.com/Using_Typescript_and_Scss		** Original wiki: https://en.doc.boardgamearena.com/Using_Typescript_and_Scss


	===PHP Intellisense===		===PHP Intellisense===

Victoria La: /* Intellisense - Navigation/Auto-complete */

2026-03-14T12:51:06Z

Intellisense - Navigation/Auto-complete

← Older revision		Revision as of 14:51, 14 March 2026
Line 18:		Line 18:
	=== JavaScript Intellisense ===		=== JavaScript Intellisense ===

	* ~~Because of~~ dojo ~~style class/method declarations most IDE won't be able to index main JavaScript file properly (i.e. go to definition of function~~ and ~~such)~~. If ~~you manage to get~~ it ~~working in VS code, let us know how~~.		* Since BGA framework ditched dojo in 2025 we can rejoice and enjoy full ide support. If try it for old dojo projects - it does not really work.

	* ~~There is a~~ way to re-~~structure code~~ to ~~avoid using this style~~, ~~but~~ this is not for beginners. ~~Do not use this on your first game!~~ https://en.doc.boardgamearena.com/~~BGA_Studio_Cookbook#Avoiding_code_in_dojo_declare_style~~		* A good way to improve auto-complete and such is to use Typescript and SCSS, this is not for the beginners.
	** There is also a complete example of a "dojo-less" project, it also includes a (incomplete) typescript definition file (.d.ts) for auto-completion of js BGA interfaces https://github.com/elaskavaia/bga-dojoless		** Original wiki: https://en.doc.boardgamearena.com/Using_Typescript_and_Scss

	* Another way to improve auto-complete and such is to use Typescript and SCSS, this is not for the beginners.
	** Original wiki: https://en.doc.boardgamearena.com/Using_Typescript_and_Scss
	** There is also 3rd party software that automates typescript template above: [[BGA Type Safe Template]]. It claims to offers a much cleaner initial file, clearer workflow, and nearly complete type and autofill support for whatever you may need.

	===PHP Intellisense===		===PHP Intellisense===

Thoun: /* Unit testing */

2026-03-12T09:20:04Z

Unit testing

← Older revision		Revision as of 11:20, 12 March 2026
Line 47:		Line 47:
	If using phpunit, install it via composer somewhere in home directory, i.e.		If using phpunit, install it via composer somewhere in home directory, i.e.
	cd /home/<yourusername>/php-composer		cd /home/<yourusername>/php-composer
	composer require --dev phpunit/phpunit ^11		composer require --dev phpunit/phpunit ^13

	Then add this path to include paths in settings		Then add this path to include paths in settings
Line 54:		Line 54:
	"/home/<yourusername>/php-composer"		"/home/<yourusername>/php-composer"
	],		],

	~~Also add this to your .bashrc~~
	~~phpunit() {~~
	~~/home/<yourusername>/php-composer/vendor/bin/phpunit \~~
	~~-c "$PWD/phpunit.xml.dist" \~~
	~~--bootstrap "$PWD/tests/bootstrap.php" \~~
	~~"$@"~~
	}

	~~With that, you should be able to run the tests with one of the following commands at the root of your project :~~
	~~phpunit~~
	~~phpunit tests/BoardManagerTest.php~~
	~~phpunit --filter testGivesExtraTime~~

	See more about unit testing in [[Testing by developer]]		See more about unit testing in [[Testing by developer]]

Thoun: /* Unit testing */

2026-03-12T09:13:42Z

Unit testing

← Older revision		Revision as of 11:13, 12 March 2026
Line 46:		Line 46:

	If using phpunit, install it via composer somewhere in home directory, i.e.		If using phpunit, install it via composer somewhere in home directory, i.e.
	cd /home/~~victoria~~/php-composer		cd /home/<yourusername>/php-composer
	composer require --dev phpunit/phpunit ^11		composer require --dev phpunit/phpunit ^11

Line 52:		Line 52:

	"intelephense.environment.includePaths": [		"intelephense.environment.includePaths": [
	"/home/~~victoria~~/php-composer"		"/home/<yourusername>/php-composer"
	],		],

			Also add this to your .bashrc
			phpunit() {
			/home/<yourusername>/php-composer/vendor/bin/phpunit \
			-c "$PWD/phpunit.xml.dist" \
			--bootstrap "$PWD/tests/bootstrap.php" \
			"$@"
			}

			With that, you should be able to run the tests with one of the following commands at the root of your project :
			phpunit
			phpunit tests/BoardManagerTest.php
			phpunit --filter testGivesExtraTime

	See more about unit testing in [[Testing by developer]]		See more about unit testing in [[Testing by developer]]

Thoun: /* File Sync */

2026-03-05T13:19:00Z

File Sync

← Older revision		Revision as of 15:19, 5 March 2026
Line 87:		Line 87:
	"package-lock.json",		"package-lock.json",
	"yarn.lock",		"yarn.lock",
	~~"tests",~~
	"misc",		"misc",
	"node_modules",		"node_modules",
Line 93:		Line 92:
	"bga-framework.d.ts",		"bga-framework.d.ts",
	"* *",		"* *",
	"sync-helpers.sh"		"sync-helpers.sh",
			"vendor",
			".phpunit.cache"
	],		],
	"syncOption": {		"syncOption": {

Thoun: /* File Sync */

2025-12-09T09:21:08Z

File Sync

← Older revision		Revision as of 11:21, 9 December 2025
Line 85:		Line 85:
	".git",		".git",
	".DS_Store",		".DS_Store",
			"package-lock.json",
			"yarn.lock",
			"tests",
			"misc",
			"node_modules",
			"_ide_helper.php",
	"bga-framework.d.ts",		"bga-framework.d.ts",
	"* *"		"* *",
			"sync-helpers.sh"
	],		],
	"syncOption": {		"syncOption": {