Version 2.10.0

.env.example

@@ -3,30 +3,44 @@ APP_ENV=local
 APP_KEY=
 APP_DEBUG=true
 APP_URL=http://localhost
+#APP_CERT=
+#APP_CERT_KEY=
 
-LOG_CHANNEL=stack
-LOG_DEPRECATIONS_CHANNEL=null
-LOG_LEVEL=debug
-
-DB_CONNECTION=mysql
-DB_HOST=127.0.0.1
-DB_PORT=3306
-DB_DATABASE=laravel
-DB_USERNAME=root
-DB_PASSWORD=
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
 
 BROADCAST_DRIVER=log
-CACHE_DRIVER=file
+
+BLOG_ENABLE_CATEGORIES_WIDGET=true
+BLOG_ENABLE_TAGS_WIDGET=true
+BLOG_ENABLE_GITHUB_ACTIVITY_WIDGET=true
+
+CACHE_STORE=file
+
+COMMANDS_WHITELIST=
+
+DB_CONNECTION=sqlite
+#DB_HOST=127.0.0.1
+#DB_PORT=3306
+#DB_DATABASE=laravel
+#DB_USERNAME=root
+#DB_PASSWORD=
+
+# todo: Should replace with Pennant
+ENABLE_BLOG=true
+ENABLE_PROJECTS=true
+
 FILESYSTEM_DRIVER=local
-QUEUE_CONNECTION=sync
-SESSION_DRIVER=file
-SESSION_LIFETIME=120
 
-MEMCACHED_HOST=127.0.0.1
+# custom vars for ImageService
+#IMAGE_SERVICE_ASSETS_DISK=
 
-REDIS_HOST=127.0.0.1
-REDIS_PASSWORD=null
-REDIS_PORT=6379
+LOG_CHANNEL=stack
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
 
 MAIL_MAILER=smtp
 MAIL_HOST=mailhog
@@ -37,16 +51,46 @@ MAIL_ENCRYPTION=null
 MAIL_FROM_ADDRESS=null
 MAIL_FROM_NAME="${APP_NAME}"
 
-AWS_ACCESS_KEY_ID=
-AWS_SECRET_ACCESS_KEY=
-AWS_DEFAULT_REGION=us-east-1
-AWS_BUCKET=
-AWS_USE_PATH_STYLE_ENDPOINT=false
+MEMCACHED_HOST=127.0.0.1
+
+MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
+MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
 
 PUSHER_APP_ID=
 PUSHER_APP_KEY=
 PUSHER_APP_SECRET=
 PUSHER_APP_CLUSTER=mt1
 
-MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
-MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
+QUEUE_CONNECTION=sync
+
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+SESSION_DRIVER=file
+SESSION_LIFETIME=120
+
+UPLOAD_DISK=public
+UPLOAD_FILE_HASH=sha256
+
+#VITE_CERT=${APP_CERT}
+#VITE_CERT_KEY=${APP_CERT_KEY}
+#VITE_SERVER_HOST=
+# listen for container-external connections, for example
+#VITE_SERVER_HOST=0.0.0.0
+#VITE_SERVER_HTTPS=
+#VITE_SERVER_HMR_HOST=
+#VITE_SERVER_PORT=
+
+#X_ACCESS_TOKEN=
+#X_ACCESS_TOKEN_SECRET=
+#X_ACCOUNT_ID=
+## alt names: consumer key / consumer secret
+#X_API_KEY=
+#X_API_SECRET=
+#X_BEARER_TOKEN=
+#X_CLIENT_ID=
+#X_CLIENT_SECRET=
+#X_CARD_TYPE=
+#X_DEFAULT_IMAGE=
+#X_USERNAME=

.env.testing

@@ -1,23 +1,31 @@
 APP_NAME=elliotderhay.com
-APP_ENV=local
+APP_ENV=testing
 APP_KEY=base64:8t7jSZh2Ycd5OdTYNFUP+08SiCEbtnZcw67N37EGOT0=
 APP_DEBUG=true
-APP_URL=https://elliotderhay.lndo.site
+APP_URL=http://localhost
 
-LOG_CHANNEL=stack
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+BROADCAST_CONNECTION=log
+
+CACHE_STORE=file
+CACHE_PREFIX=
 
 DB_CONNECTION=sqlite
 DB_DATABASE=:memory:
 
-BROADCAST_DRIVER=log
-CACHE_DRIVER=database
-QUEUE_CONNECTION=sync
-SESSION_DRIVER=file
-SESSION_LIFETIME=120
+FILESYSTEM_DISK=local
 
-REDIS_HOST=127.0.0.1
-REDIS_PASSWORD=null
-REDIS_PORT=6379
+GITHUB_API_TOKEN='testing'
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
 
 MAIL_MAILER=smtp
 MAIL_HOST=smtp.mailtrap.io
@@ -30,20 +38,36 @@ MAIL_FROM_NAME="${APP_NAME}"
 MAIL_TO_NAME='John Doe'
 MAIL_TO_ADDRESS='[email protected]'
 
-TWITTER_API_KEY=test_key
-TWITTER_API_SECRET=test_secret
+MEMCACHED_HOST=127.0.0.1
 
-AWS_ACCESS_KEY_ID=
-AWS_SECRET_ACCESS_KEY=
-AWS_DEFAULT_REGION=us-east-1
-AWS_BUCKET=
+MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
+MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
 
 PUSHER_APP_ID=
 PUSHER_APP_KEY=
 PUSHER_APP_SECRET=
 PUSHER_APP_CLUSTER=mt1
 
-MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
-MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
+QUEUE_CONNECTION=sync
 
-GITHUB_API_TOKEN='testing'
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+SESSION_DRIVER=file
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+VITE_APP_NAME="${APP_NAME}"
+
+#X_API_KEY=
+#X_API_SECRET=
+#X_BEARER_TOKEN=
+#X_CLIENT_ID=
+#X_CLIENT_SECRET=
+#X_CARD_TYPE=
+#X_DEFAULT_IMAGE=
+#X_USERNAME=

CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## Version 2.10.0
+
+### Changes
+
+- Set `::selection` color
+- [#184][is_184]: Use Volt for blog ([#206][pr_206])
+- [#205][is_205]: Remove direct Alpine dependency
+- [#208][is_208]: Make 'remote' disk for `ImageService` configurable
+- Update `.env.example` to be more complete
+	- Also alphabetize this while I'm at it; this was driving me crazy...
+- [#202][is_202]: Condense migrations
+- [#203][is_203]: Slim down cookie banner ([#210][pr_210])
+- Minor housekeeping
+- [#191][is_191]: Reimplement login activity ([#213][pr_213])
+
+### Fixed
+
+- [#204][is_204]: Delete dependabot workflow file
+- [#201][is_201]: Use fallback cache driver for `ImageService` ([#207][pr_207])
+- [#200][is_200]: Remove risk of boot-time dependency on `pennant` table ([#209][pr_209])
+- [#198][is_198]: Ensure lightbox opens only where it's needed ([#212][pr_212])
+- As part of [#212][pr_212], make sure lightbox content is constrained to viewport
+- [#211][is_211]: Fix accidentally redeclaring global constant `anchors`
+
+[is_184]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/184
+
+[is_191]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/191
+
+[is_198]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/198
+
+[is_200]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/200
+
+[is_201]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/201
+
+[is_202]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/202
+
+[is_203]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/203
+
+[is_204]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/204
+
+[is_205]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/205
+
+[is_208]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/208
+
+[is_211]: https://github.com/JSn1nj4/ElliotDerhay.com/issues/211
+
+[pr_206]: https://github.com/JSn1nj4/ElliotDerhay.com/pull/206
+
+[pr_207]: https://github.com/JSn1nj4/ElliotDerhay.com/pull/207
+
+[pr_209]: https://github.com/JSn1nj4/ElliotDerhay.com/pull/209
+
+[pr_210]: https://github.com/JSn1nj4/ElliotDerhay.com/pull/210
+
+[pr_212]: https://github.com/JSn1nj4/ElliotDerhay.com/pull/212
+
+[pr_213]: https://github.com/JSn1nj4/ElliotDerhay.com/pull/213
+
 ## Version 2.9.2
 
 ### Changes

README.md

@@ -2,6 +2,57 @@
 
 This project is my personal website.
 
+## Setup
+
+### Initial
+
+- Clone the project.
+- Copy `.env.example` to `.env`.
+
+### Database
+
+- To use SQLite (the default), create the file at `database/database.sqlite`.
+- To use MySQL or PostgreSQL, create your DB and configure the `DB_*` vars.
+
+### Install Dependencies
+
+1. Make sure you meet the project's runtime requirements:
+	- If you use ASDF, run `asdf install`
+	- If you manage runtimes another way:
+		- PHP 8.2.x
+		- Node 20.x
+		- Yarn 1.22.x
+2. Run `composer install`.
+3. Run `yarn` to install dependencies.
+	- If you use vanilla `npm` instead, I'm terribly sorry. ¯\\\_(ツ)\_/¯
+
+### Finish
+
+- Generate project key: `php artisan key:generate`.
+- Run migrations: `php artisan migrate`.
+- Link public storage: `php artisan storage:link`
+- _Optionally_, seed dev data: `php artisan db:seed --seeder=DemoSeeder`
+
+---
+
+### _A Note about caching_
+
+This project's `.env` uses the `file` cache store. But Laravel 11.x's default cache store is `database`. Feel free to
+change this or comment it out to use the default.
+
+### _A note on the `ImageService`_
+
+There are a couple of helpers used around the project (`assets_url()` and `image_url()`) that hook into
+the `App\Services\ImageService` class. This exists to:
+
+- allow permanent image storage to live on another `disk`
+- *Still* provide fast load times for images by "caching" them on the same disk as the application at first request
+
+The ENV var `IMAGE_SERVICE_REMOTE_DISK` lets you choose where to look for downloadable assets. It defaults to a local
+disk to ensure these features work as intended after cloning.
+
+---
+
 [Changelog](CHANGELOG.md)
 
-[License](LICENSE.md)
+[License](LICENSE.md)