v1.4.1 by b-at-neu · Pull Request #18 · SGAOperations/senate-path

b-at-neu · 2026-02-16T01:55:43Z

This pull request introduces a robust local development workflow for the database using Docker, standardizes the singleton settings pattern in the application, and improves developer onboarding and documentation. The changes streamline how developers set up and manage the local PostgreSQL database, enforce best practices for the settings record, and clarify project conventions.

Local Development Database Workflow:

Added a docker-compose.yml file to enable developers to spin up a local PostgreSQL database using Docker with persistent storage and health checks.
Updated package.json scripts to include commands for starting, stopping, and resetting the local database container, as well as running Prisma migrations and Studio.
Modified .env.example to provide ready-to-use local database connection strings for Docker-based development, and clarified production configuration.
Enhanced the README.md with detailed instructions for local database setup, workflow, troubleshooting, and command references, emphasizing Docker usage over manual PostgreSQL installation. [1] [2] [3] [4]

Settings Singleton Pattern:

Refactored the settings logic in lib/actions/settings.ts and lib/data/settings.ts to use a fixed ID ('default') and atomic upsert operations, ensuring only one settings record exists and simplifying retrieval and updates. [1] [2] [3] [4] [5]
Updated the settings form in app/admin/settings/settings-form.tsx to refresh the page after a successful update, ensuring UI reflects the latest settings. [1] [2] [3]
Added a migration to set the default value of endorsementsOpen to true in the database schema.

Developer Experience & Documentation:

Added a comprehensive .github/copilot-instructions.md to document commit, branch, and PR conventions, architectural patterns, file organization, and best practices for the project.
Improved error handling in lib/db.ts to provide clear instructions if DATABASE_URL is missing, guiding developers to set up their environment correctly.

Dependency Updates:

Updated minor versions of several dependencies and devDependencies for improved stability and compatibility. [1] [2]

Local Development & Database Management

Introduced Docker-based local PostgreSQL setup via docker-compose.yml and supporting package.json scripts for starting, stopping, and resetting the database. [1] [2]
Updated .env.example and README.md to document and facilitate Docker-based database development, including troubleshooting and workflow tips. [1] [2] [3] [4] [5]

Settings Singleton Refactor

Enforced a singleton pattern for the settings record using a fixed ID and upsert logic in both data access and mutation, preventing duplicates and simplifying logic. [1] [2] [3] [4] [5]
Updated the admin settings form to refresh after updates, ensuring the UI stays in sync. [1] [2] [3]
Added migration to set default value for endorsementsOpen.

Developer Experience & Documentation

Added .github/copilot-instructions.md to standardize contribution and architectural practices.
Improved error handling for missing database environment variables.

Dependency Updates

Bumped several dependencies and devDependencies to latest patch versions. [1] [2]

Bumps the development-dependencies group with 2 updates: [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) and [@types/react](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/react). Updates `@types/node` from 25.2.0 to 25.2.3 - [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases) - [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node) Updates `@types/react` from 19.2.13 to 19.2.14 - [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases) - [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/react) --- updated-dependencies: - dependency-name: "@types/node" dependency-version: 25.2.3 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: development-dependencies - dependency-name: "@types/react" dependency-version: 19.2.14 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: development-dependencies ... Signed-off-by: dependabot[bot] <support@github.com>

Bumps the production-dependencies group with 2 updates: [dotenv](https://github.com/motdotla/dotenv) and [lucide-react](https://github.com/lucide-icons/lucide/tree/HEAD/packages/lucide-react). Updates `dotenv` from 17.2.4 to 17.3.1 - [Changelog](https://github.com/motdotla/dotenv/blob/master/CHANGELOG.md) - [Commits](motdotla/dotenv@v17.2.4...v17.3.1) Updates `lucide-react` from 0.563.0 to 0.564.0 - [Release notes](https://github.com/lucide-icons/lucide/releases) - [Commits](https://github.com/lucide-icons/lucide/commits/0.564.0/packages/lucide-react) --- updated-dependencies: - dependency-name: dotenv dependency-version: 17.3.1 dependency-type: direct:production update-type: version-update:semver-minor dependency-group: production-dependencies - dependency-name: lucide-react dependency-version: 0.564.0 dependency-type: direct:production update-type: version-update:semver-minor dependency-group: production-dependencies ... Signed-off-by: dependabot[bot] <support@github.com>

#5 Create Copilot Instructions

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

…n-dependencies-6b8dbf03b7 Bump the production-dependencies group with 2 updates

…nt-dependencies-bef923c98e Bump the development-dependencies group with 2 updates

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

…ettings #14 Fix Endorsements Open Default Value

#8 Fix Startup Issue with Settings

#9 Create A Plan For Local Database

…pilot/fix-saving-settings-issue

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#11 Fix Saving Settings Issue and Prevent Duplicate Rows

vercel · 2026-02-16T01:55:47Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
senate-path	Ready	Preview, Comment	Feb 16, 2026 1:56am

dependabot Bot and others added 30 commits February 14, 2026 16:51

#5 create copilot instructions file

c90ea7f

#5 update file organization structure

81a5287

Merge pull request #6 from b-at-neu/5-create-copilot-instructions

be5bd95

#5 Create Copilot Instructions

Initial plan

23b537c

#0 improve settings initialization with better error handling

49967e4

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#0 improve error detection for database initialization errors

24edf38

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#0 consolidate duplicate error handling logic

2a07925

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

Initial plan

88748ed

#9 add docker-based local database setup

1745431

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#9 add sleep to db:reset for container startup

7614986

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

Initial plan

4437ab5

#8 fail deployment when database connection is unavailable

f577a1e

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#9 use docker compose --wait for cross-platform compatibility

481e985

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

Merge pull request #1 from b-at-neu/dependabot/npm_and_yarn/productio…

6c0d7e6

…n-dependencies-6b8dbf03b7 Bump the production-dependencies group with 2 updates

Merge pull request #2 from b-at-neu/dependabot/npm_and_yarn/developme…

a386647

…nt-dependencies-bef923c98e Bump the development-dependencies group with 2 updates

#9 add security warning and improve windows troubleshooting

2e3d355

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#8 extract default settings to constant and include all fields

b458d7e

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#11 remove react cache from getSettings to fix persistence issue

74e3b33

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#8 add global database connection check at startup

ce05fce

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#9 remove docker warning and simplify deployment notes

d988b08

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#8 remove redundant db connect call to prevent connection leaks

2b5cec8

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

Merge branch 'dev' into copilot/create-local-database-plan

eb16a35

#9 add database url validation with clear error message

5c65f58

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

Initial plan

907a6b0

#14 add migration to fix endorsementsOpen default value

93dc22f

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#8 remove instrumentation and let database errors propagate naturally

00eccf9

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

Merge pull request #15 from b-at-neu/copilot/fix-migration-mismatch-s…

9d32faa

…ettings #14 Fix Endorsements Open Default Value

Merge pull request #8 from b-at-neu/copilot/fix-startup-issue-settings

2cd8d29

#8 Fix Startup Issue with Settings

b-at-neu and others added 8 commits February 14, 2026 13:41

Merge branch 'dev' into copilot/create-local-database-plan

e9b27ec

Merge pull request #10 from b-at-neu/copilot/create-local-database-plan

cfb4262

#9 Create A Plan For Local Database

Merge branch 'dev' of https://github.com/b-at-neu/senate-path into co…

2aa18aa

…pilot/fix-saving-settings-issue

#11 add router.refresh() to update ui after saving settings

b16d523

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#11 use prisma upsert with fixed id to prevent duplicate settings rows

749992c

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

#11 reduce duplication by extracting settings data object

d8fde4d

Co-authored-by: b-at-neu <144247685+b-at-neu@users.noreply.github.com>

Merge pull request #12 from b-at-neu/copilot/fix-saving-settings-issue

a97109b

#11 Fix Saving Settings Issue and Prevent Duplicate Rows

Bump version from 1.4.0 to 1.4.1

65f5c2d

b-at-neu self-assigned this Feb 16, 2026

b-at-neu merged commit 6c510be into main Feb 16, 2026
2 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

v1.4.1#18

v1.4.1#18
b-at-neu merged 38 commits intomainfrom
dev

b-at-neu commented Feb 16, 2026

Uh oh!

vercel Bot commented Feb 16, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

b-at-neu commented Feb 16, 2026

Uh oh!

vercel Bot commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

vercel Bot commented Feb 16, 2026 •

edited

Loading