Docket v1: self-hosted read-later app

.editorconfig

@@ -0,0 +1,18 @@
+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
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[{compose,docker-compose}.{yml,yaml}]
+indent_size = 4

.env.example

@@ -0,0 +1,78 @@
+APP_NAME=Docket
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL=http://localhost:8000
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+# APP_MAINTENANCE_STORE=database
+
+# PHP_CLI_SERVER_WORKERS=4
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+# Single-user SQLite app: the DB_HOST/PORT/etc. block is unused.
+DB_CONNECTION=sqlite
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+# CACHE_PREFIX=
+
+MAIL_MAILER=log
+MAIL_SCHEME=null
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_FROM_ADDRESS="docket@example.com"
+MAIL_FROM_NAME="${APP_NAME}"
+
+VITE_APP_NAME="${APP_NAME}"
+
+# Docket ---------------------------------------------------------------
+
+# The single owner account (there is no registration flow). The installer
+# (php artisan docket:install, or /install in a browser) fills in the
+# name/email and creates the account directly, so you normally never edit
+# these by hand. They are the fallbacks used if the database is ever
+# re-seeded from scratch.
+DOCKET_USER_PASSWORD=
+# DOCKET_USER_NAME="Docket Owner"
+# DOCKET_USER_EMAIL=owner@example.com
+
+# User-Agent sent when fetching saved pages. Some sites block unknown
+# agents; override it here if one you read often does.
+# DOCKET_USER_AGENT=
+
+# Off-site backup bucket (S3-compatible: Backblaze B2 or Cloudflare R2).
+# R2 endpoint looks like https://<account-id>.r2.cloudflarestorage.com
+# B2 endpoint looks like https://s3.<region>.backblazeb2.com
+BACKUP_ACCESS_KEY_ID=
+BACKUP_SECRET_ACCESS_KEY=
+BACKUP_BUCKET=
+BACKUP_ENDPOINT=
+BACKUP_REGION=auto
+# Failure alerts go here; falls back to DOCKET_USER_EMAIL when unset.
+# BACKUP_NOTIFY_EMAIL=
+# Optional: encrypt backup archives with this password (keep a copy in
+# your password manager too: no password, no restore). Leave commented
+# out to disable encryption; an empty value breaks archive verification.
+# BACKUP_ARCHIVE_PASSWORD=

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+/.github export-ignore
+CHANGELOG.md export-ignore
+.styleci.yml export-ignore

.gitignore

@@ -0,0 +1,28 @@
+*.log
+.DS_Store
+# Ignore all dot-folders (editor/tool configs), except important ones.
+.*/
+!/.github
+!/.styleci.yml
+/.playwright-mcp
+.env
+.env.backup
+.env.production
+.phpactor.json
+.phpunit.result.cache
+/auth.json
+/database/*.sqlite
+/database/*.sqlite-journal
+/node_modules
+/storage/app/tmp
+/public/build
+/public/fonts-manifest.dev.json
+/public/hot
+/public/storage
+/storage/*.key
+/storage/pail
+/vendor
+_ide_helper.php
+Homestead.json
+Homestead.yaml
+Thumbs.db

.mcp.json

@@ -0,0 +1,11 @@
+{
+    "mcpServers": {
+        "laravel-boost": {
+            "command": "php",
+            "args": [
+                "artisan",
+                "boost:mcp"
+            ]
+        }
+    }
+}

.npmrc

@@ -0,0 +1,2 @@
+ignore-scripts=true
+audit=true

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ajay D'Souza (Beyond Develop Ltd)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.