Updated templates.

Author: gjwgit

.githooks/pre-push

@@ -7,6 +7,13 @@
 #
 # If this script exits with a non-zero status nothing will be pushed.
 
+PVER=$(egrep '^version:' pubspec.yaml | cut -d' ' -f2 | cut -d'+' -f1)
+
+if [ -d snap ]; then
+    printf "\e[33;1m%s\e[0m\n" 'Update snap version.'
+    perl -pi -e "s|^version:.*|version: ${PVER}|" snap/snapcraft.yaml;
+fi
+
 # Flutter Analyze
 
 printf "\e[33;1m%s\e[0m\n" 'Running flutter analyze.'

.github/ISSUE_TEMPLATE/bug_report.md

@@ -54,6 +54,6 @@ Flutter Version:
 
 Checklist for closing the issue:
 
-- [ ] `make test`
-- [ ] `make qtest`
-- [ ] [Task specific requirements.]
+- [ ] No errors from `make prep`
+- [ ] All tests pass `make qtest`
+- [ ] [Issue specific requirements.]

.github/ISSUE_TEMPLATE/feature_request.md

@@ -18,7 +18,9 @@ So that as a user I can [clear and concise benefit].
 
 Checklist for closing the issue:
 
-- [ ] All tests pass
+- [ ] No errors from `make prep`
+- [ ] All tests pass `make qtest`
+- [ ] [Issue specific requirements.]
 
 ## Alternatives
 

.github/workflows/ci.yaml

@@ -13,7 +13,7 @@ on:
     types: [opened, reopened, synchronize]
 
 env:
-  FLUTTER_VERSION: '3.35.6'
+  FLUTTER_VERSION: '3.38.5'
 
 jobs:
 
@@ -104,20 +104,25 @@ jobs:
         uses: lycheeverse/lychee-action@v2
         with: # Don't fail for now but then create an issue - useful?
           args:
-            --verbose
+            --exclude-file .lycheeignore
             --no-progress
+            '*.md'
+            './**/*.dart'
             'assets/**/*.md'
             'assets/**/*.html'
-            'lib/**/*.dart'
-          fail: false
-
-      - name: Create Issue From File
-        if: steps.lychee.outputs.exit_code != 0
-        uses: peter-evans/create-issue-from-file@v5
-        with:
-          title: Link Checker Report
-          content-filepath: ./lychee/out.md
-          labels: report, automated issue
+          fail: true
+
+      # 20251030 gjw Remove the automatic creation of an issue for
+      # now. It is creating too many and I am simply closing them. The
+      # failure of the lint test itself should be enough.
+
+      # - name: Create Issue From File
+      #   if: steps.lychee.outputs.exit_code != 0
+      #   uses: peter-evans/create-issue-from-file@v5
+      #   with:
+      #     title: Link Checker Report
+      #     content-filepath: ./lychee/out.md
+      #     labels: report, automated issue
 
   locmax:
     runs-on: ubuntu-latest

.gitignore

@@ -98,16 +98,6 @@ migrate_working_dir/
 
 .vscode/
 
-# Flutter/Dart/Pub related
-**/doc/api/
-**/ios/Flutter/.last_build_id
-.dart_tool/
-.flutter-plugins
-.flutter-plugins-dependencies
-.pub-cache/
-.pub/
-/build/
-
 # Symbolication related
 app.*.symbols
 
@@ -158,6 +148,7 @@ analysis_benchmark.json
 .flutter-plugins-dependencies
 **/generated_plugin_registrant.dart
 .packages
+.pub-cache/
 .pub-preload-cache/
 .pub/
 build/
@@ -237,12 +228,17 @@ android/app/.cxx/
 **/ios/ServiceDefinitions.json
 **/ios/Runner/GeneratedPluginRegistrant.*
 
+# ios/macos generated project files
 ios/Flutter/
 ios/Runner.xcodeproj/
 ios/Runner.xcworkspace/
 ios/Runner/
 ios/RunnerTests/
 
+# Backups of ios/macos project config yml and Podfile
+ios/Podfile-*
+ios/project-*.yml
+
 #-----------------------------------------------------------------------
 # macOS
 #-----------------------------------------------------------------------
@@ -253,6 +249,14 @@ ios/RunnerTests/
 **/macos/Flutter/ephemeral
 **/xcuserdata/
 
+# ios/macos generated project files
+macos/Runner.xcodeproj/
+macos/Runner.xcworkspace/
+
+# Backups of ios/macos project config yml and Podfile
+macos/Podfile-*
+macos/project-*.yml
+
 #-----------------------------------------------------------------------
 # Windows
 #-----------------------------------------------------------------------

.lycheeignore

@@ -0,0 +1,52 @@
+# Lychee link checker ignore patterns
+# These URLs are expected to fail in CI but are valid in context
+
+# Localhost OAuth callbacks used in integration tests
+
+http://localhost:44007/
+
+http://localhost:8000/
+
+# POD OAuth endpoints that require authentication parameters
+
+https://pods.dev.solidcommunity.au/.oidc/auth
+https://pods.dev.solidcommunity.au/.oidc/token
+
+# Example POD URLs that are protected resources
+
+https://pods.solidcommunity.au/my-moviestar/profile/card#me
+
+# POD server base URL - has temporary availability issues.
+
+https://pods.solidcommunity.au/
+
+# ANU Software Innovation Institute website (frequent timeouts in CI)
+
+https://sii.anu.edu.au/
+
+# OpenStreetMap APIs - require User-Agent headers (400 Bad Request in CI)
+
+https://nominatim.openstreetmap.org/reverse
+https://tile.openstreetmap.org/
+
+# Map Tile Providers (Regex patterns) from geopod
+
+https://tiles\.stadiamaps\.com/.*
+https://server\.arcgisonline\.com/.*
+https://.*\.basemaps\.cartocdn\.com/.*
+https://.*\.tile-cyclosm\.openstreetmap\.fr/.*
+
+# Ignore the template index file.
+
+web/**
+
+# Licenses. Note that gnu.org is throttled so do not check it.
+
+https://www.gnu.org/licenses/
+https://opensource.org/license/gpl-3-0
+
+# Ontology definitions
+
+http://xmlns.com/foaf/0.1/
+http://purl.org/dc/terms/
+https://solidcommunity.au/predicates/*

support/flutter.mk

@@ -25,6 +25,7 @@ flutter:
   emu	    Run with the android emulator;
   linux     Run with the linux device;
   qlinux    Run with the linux device and debugPrint() turned off;
+  macos     Run with the macos device;
 
   prep      Prep for PR by running tests, checks, docs.
   push      Do a git push and bump the build number if there is one.
@@ -45,20 +46,25 @@ flutter:
   ignore          Look for usage of ignore directives.
   license	  Look for missing top license in source code.
 
-  test	    Run flutter testing.
-  itest	    Run flutter interation testing.
-  qtest	    Run above test with PAUSE=0.
-  coverage  Run with `--coverage`.
-    coview  View the generated html coverage in browser.
+  test	    	  Run flutter testing.
+  itest	    	  Run flutter interation testing.
+  qtest	   	  Run above test with PAUSE=0.
+    qtest.all	  Run qtest with output redirected - good running all tests.
+  coverage  	  Run with `--coverage`.
+    coview  	  View the generated html coverage in browser.
 
   riverpod  Setup `pubspec.yaml` to support riverpod.
   runner    Build the auto generated code as *.g.dart files.
 
   desktops  Set up for all desktop platforms (linux, windows, macos)
 
   distributions
-    apk	    Builds installers/$(APP).apk
-    tgz     Builds installers/$(APP).tar.gz
+    apk	          Builds installers/$(APP).apk.
+    tgz           Builds installers/$(APP).tar.gz.
+    dmg-unsigned  Builds unsigned macos app.
+    dmg-dev       Builds macos app with development certificate.
+    dmg-staging   Builds macos app with distribution certificate.
+                  (TODO convert to dmg).
 
   publish   Publish a package to pub.dev
 
@@ -106,22 +112,26 @@ chrome:
 pubspec.lock:
 	flutter pub get
 
+.PHONY: upgrade
+upgrade:
+	flutter pub upgrade
+
 .PHONY: linux
-linux: pubspec.lock $(BUILD_RUNNER)
+linux: pubspec.lock $(BUILD_RUNNER) upgrade
 	flutter run --device-id linux
 
 # Turn off debugPrint() output.
 
 .PHONY: qlinux
-qlinux: pubspec.lock $(BUILD_RUNNER)
+qlinux: pubspec.lock $(BUILD_RUNNER) upgrade
 	flutter run --dart-define DEBUG_PRINT="FALSE" --device-id linux
 
 .PHONY: macos
-macos: $(BUILD_RUNNER)
+macos: $(BUILD_RUNNER) upgrade
 	flutter run --device-id macos
 
 .PHONY: android
-android: $(BUILD_RUNNER)
+android: $(BUILD_RUNNER) upgrade
 	flutter run --device-id $(shell flutter devices | grep android | tr '•' '|' | tr -s '|' | tr -s ' ' | cut -d'|' -f2 | tr -d ' ')
 
 .PHONY: emu
@@ -216,7 +226,7 @@ locmax:
 		| egrep -v '^ *$$' \
 		| egrep -v '^ *[)},]+, *$$' \
 		| wc -l \
-		| numfmt --grouping); \
+		| numfmt --format "%'f"); \
 	numf=$$(find lib -name "*.dart" -type f | wc -l); \
 	output=$$(find lib -name "*.dart" -exec sh -c ' \
 		lines=$$(bash $(LOC) "$$1"); \
@@ -455,6 +465,25 @@ realclean::
 	flutter clean
 	flutter pub get
 
+# Create a macos app
+# [20251029 jesscmoore] TODO: add converting to dmg
+# Build unsigned macos app
+dmg-unsigned::
+	flutter clean
+	flutter build macos --release --flavor unsigned
+
+# Build macos app signed with development certificate for testing
+# by App Developer Program togaware registered devices
+dmg-dev::
+	flutter clean
+	flutter build macos --release --flavor dev
+
+# Build macos app signed with app store distribution for testing
+# on Testflight or publishing
+dmg-staging:
+	flutter clean
+	flutter build macos --release --flavor staging
+
 # For the `dev` branch only, update the version sequence number prior
 # to a push (relies on the git.mk being loaded after this
 # flutter.mk). This is only undertaken through `make push` rather than