Containerized setup based on Bedrock

.dockerignore

@@ -0,0 +1,13 @@
+# ignore everything by default
+*
+
+# copy these directories
+!bin/
+!docker/fairpm-wordpress
+
+# copy these files
+!.env
+!README.md
+!composer.json
+!composer.lock
+

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.env.example

@@ -0,0 +1,18 @@
+DATABASE_URL='mysql://wp:password@fairpm-db:3306/wordpress'
+DB_PREFIX='wp_'
+
+WP_ENV='development'
+WP_HOME='https://local.fair.pm'
+WP_SITEURL="${WP_HOME}/wp"
+
+# WP_DEBUG_LOG='/path/to/debug.log'
+
+###> Do not remove this comment, and do not add anything under it, as it will be replaced on install <###
+AUTH_KEY='generateme'
+SECURE_AUTH_KEY='generateme'
+LOGGED_IN_KEY='generateme'
+NONCE_KEY='generateme'
+AUTH_SALT='generateme'
+SECURE_AUTH_SALT='generateme'
+LOGGED_IN_SALT='generateme'
+NONCE_SALT='generateme'

.gitignore

@@ -1,18 +1,26 @@
-.env.production
-gp-data/
+#### ignore all dotfiles and dot-dirs, with exceptions
+.*
+!.config/
+!.distignore
+!.dockerignore
+!.editorconfig
+!.env.example
+!.gitattributes
+!.gitignore
 
-# Installed via Composer
-content/mu-plugins/php-basic-auth/
-content/plugins/aws-ses-wp-mail/
-content/plugins/fair-plugin/
-content/plugins/git-updater/
-content/plugins/query-monitor/
-content/plugins/wp-redis/
-content/plugins/mini-fair-repo/
-content/plugins/aspireexplorer/
-content/plugins/public-post-preview/
-content/plugins/wordpress-seo/
-content/plugins/wordpress-seo-premium/
-content/themes/fair-parent-theme/
-vendor/
-wordpress/
+#### ignore these patterns
+*.bak
+*.log
+*.tmp
+*.local
+*.local.*
+*.secret
+*.secret.*
+
+#### ignore these specific directories
+/gp-data/
+/vendor/
+
+#### ignore these specific files
+auth.json
+docker-compose.override.yml

README.md

@@ -1,32 +1,26 @@
-# Server
+# fair.pm web site
 
-This is the overarching repo for the code deployed to our hosted server, running at https://fair.pm/
+This is the overarching repo for the code deployed to our hosted server, running at https://fair.pm/.  It will eventually form a template repository for wordpress installations in general, but for now it's specifically configured for the fair.pm site.
 
+## Quick Start for Local Development
 
-## Local Development
-
-This repository is pre-configured with wp-env configuration. (Better Docker Compose setup coming soon!)
-
-You can set up a local environment using:
-
-```sh
-# First, install Composer dependencies.
-composer install
-
-# Then, start an environment.
-npx @wordpress/env start
+```
+bin/init
+bin/up
 ```
 
+## Local Development 
 
-## Deployment
+The fair.pm server is built on the [Roots Bedrock](https://roots.io/bedrock/) distribution of WordPress, so all plugins and themes are managed via Composer.
 
-Deployment will eventually be automatic, but in the meantime, the infrastructure team needs to deploy the repository via Helm. Ping them when deployment is needed.
+Local development is primarily based on Docker containers, using a FrankenPHP web server container for WordPress, with other support containers defined in `docker-compose.yml`.  The default configuration is to expose the server through Traefik at https://local.fair.pm (which always resolves to localhost), but local ports can be used instead by renaming the `docker-compose.override.example.yml` file to `docker-compose.override.yml` and editing it to your needs.
 
-To ignore files from deployment, specify them in `.distignore`.
+## Deployment
 
+TODO
 
 ## License
 
 Licensed under the GNU General Public License, v2 or later. Copyright 2025 contributors.
 
-Incorporates code from [WordPress/wordpress.org](https://github.com/WordPress/wordpress.org). Licensed under the GNU General Public License, v2 or later. Copyright 2025 contributors.
+Incorporates code from [WordPress](https://github.com/WordPress/wordpress.org) and [Roots Bedrock](https://github.com/roots/bedrock). Licensed under the GNU General Public License, v2 or later. Copyright 2025 contributors.

composer.json

@@ -1,72 +1,122 @@
 {
-	"name": "fairpm/server",
-	"type": "project",
-	"repositories": {
-		"my-yoast": {
-			"type": "composer",
-			"url": "https://my.yoast.com/packages/"
-		},
-		"0": {
-			"type": "vcs",
-			"url": "https://github.com/GlotPress/GlotPress"
-		},
-		"1": {
-			"type": "vcs",
-			"url": "https://github.com/fairpm/mini-fair-repo"
-	    },
-	    {
-			"type": "vcs",
-			"url": "https://github.com/aspirepress/AspireExplorer"
-		},
-		"2": {
-			"type": "vcs",
-			"url": "https://github.com/fairpm/fair-plugin"
-		},
-		"3": {
-			"type": "vcs",
-			"url": "https://github.com/ocean90/public-post-preview"
-		}
-	},
-	"require": {
-		"composer/installers": "~2",
-		"humanmade/php-basic-auth": "^1.1",
-		"glotpress/glotpress-wp": "^4.0.1",
-		"johnbillion/query-monitor": "^3.17",
-		"johnpbloch/wordpress": "^6.8",
-		"pantheon-systems/wp-redis": "^1.4",
-		"humanmade/wp-redis-predis-client": "^0.1.2",
-		"afragen/git-updater": "^12.18",
-		"fairpm/fair-parent-theme": "~1.0.1",
-		"humanmade/aws-ses-wp-mail": "dev-master",
-		"mcaskill/composer-exclude-files": "^4.0",
-		"yoast/wordpress-seo": "*",
-		"aspirepress/aspireexplorer": "^0.2",
-		"fair/fair-plugin": "dev-main",
-		"ocean90/public-post-preview": "^3.0",
-		"yoast/wordpress-seo-premium": "^26.0",
-		"humanmade/s3-uploads": "^3.0"
-	},
-	"extra": {
-		"installer-paths": {
-			"content/plugins/{$name}/": [
-				"type:wordpress-plugin"
-			],
-			"content/mu-plugins/{$name}/": [
-				"type:wordpress-muplugin"
-			],
-			"content/themes/{$name}/": [
-				"type:wordpress-theme"
-			]
-		},
-		"exclude-from-files": [
-			"freemius/wordpress-sdk/start.php"
-		]
-	},
-	"config": {
-		"allow-plugins": {
-			"composer/installers": true,
-			"johnpbloch/wordpress-core-installer": true,
-			"mcaskill/composer-exclude-files": true
-		}
-	}
+    "name": "fairpm/server",
+    "type": "project",
+    "license": "GPL-2.0-or-later",
+    "repositories": [
+        {
+            "type": "composer",
+            "url": "https://wpackagist.org",
+            "only": [
+                "wpackagist-plugin/*",
+                "wpackagist-theme/*"
+            ]
+        },
+        {
+            "type": "vcs",
+            "url": "https://github.com/GlotPress/GlotPress",
+            "only": [
+                "glotpress/glotpress-wp"
+            ]
+        },
+        {
+            "type": "vcs",
+            "url": "https://github.com/aspirepress/AspireExplorer",
+            "only": [
+                "aspirepress/aspireexplorer"
+            ]
+        },
+        {
+            "type": "vcs",
+            "url": "https://github.com/fairpm/fair-plugin",
+            "only": [
+                "fairpm/fair-plugin"
+            ]
+        },
+        {
+            "type": "vcs",
+            "url": "https://github.com/fairpm/fair-beacon",
+            "only": [
+                "fairpm/fair-beacon"
+            ]
+        },
+        {
+            "type": "vcs",
+            "url": "https://github.com/ocean90/public-post-preview",
+            "only": [
+                "ocean90/public-post-preview"
+            ]
+        },
+        {
+            "type": "composer",
+            "url": "https://my.yoast.com/packages/",
+            "only": [
+                "yoast/*"
+            ]
+        }
+    ],
+    "require": {
+        "php": ">=8.4",
+        "ext-apcu": "*",
+        "ext-sqlite3": "*",
+        "afragen/git-updater": "^12.20.2",
+        "aspirepress/aspireexplorer": "^0.2",
+        "composer/installers": "~2",
+        "fairpm/fair-beacon": "dev-main",
+        "fairpm/fair-parent-theme": "~1.0.5",
+        "fairpm/fair-plugin": "dev-main",
+        "glotpress/glotpress-wp": "^4.0.3",
+        "humanmade/aws-ses-wp-mail": "dev-master",
+        "humanmade/php-basic-auth": "^1.1.1",
+        "humanmade/s3-uploads": "^3.0.11",
+        "humanmade/wp-redis-predis-client": "^0.1.2",
+        "johnbillion/query-monitor": "^3.20.1",
+        "mcaskill/composer-exclude-files": "^4.0.1",
+        "ocean90/public-post-preview": "^3.0.1",
+        "oscarotero/env": "^2.1.1",
+        "pantheon-systems/wp-redis": "^1.4.6",
+        "roots/bedrock-autoloader": "^1.0.4",
+        "roots/wordpress": "^6.9.0",
+        "roots/wp-config": "^1.0",
+        "vlucas/phpdotenv": "^5.6.2",
+        "wpackagist-plugin/fastly": "^1.2",
+        "wpackagist-theme/twentytwentyfive": "^1.4",
+        "yoast/wordpress-seo": ">=26.4"
+    },
+    "require-dev": {
+        "roave/security-advisories": "dev-latest"
+    },
+    "suggest": {
+        "yoast/wordpress-seo-premium": "^26.0"
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true,
+    "extra": {
+        "installer-paths": {
+            "web/app/mu-plugins/{$name}/": [
+                "type:wordpress-muplugin"
+            ],
+            "web/app/plugins/{$name}/": [
+                "type:wordpress-plugin"
+            ],
+            "web/app/themes/{$name}/": [
+                "type:wordpress-theme"
+            ]
+        },
+        "wordpress-install-dir": "web/wp",
+        "exclude-from-files": [
+            "freemius/wordpress-sdk/start.php"
+        ]
+    },
+    "config": {
+        "allow-plugins": {
+            "composer/installers": true,
+            "mcaskill/composer-exclude-files": true,
+            "roots/wordpress-core-installer": true
+        },
+        "bump-after-update": true,
+        "notify-on-install": false,
+        "optimize-autoloader": true,
+        "preferred-install": "dist",
+        "sort-packages": true
+    }
 }