Search by

northwestern-sysdev / northwestern-laravel-starter

northwestern-sysdev

A comprehensive starter kit for Laravel projects at Northwestern University

Package info

github.com/NIT-Administrative-Systems/northwestern-laravel-starter

Type:project

pkg:composer/northwestern-sysdev/northwestern-laravel-starter

Statistics

Installs: 66

Dependents: 0

Suggesters: 0

Stars: 4

Open Issues: 0


README

Northwestern Laravel Starter

PHP Version Laravel Version Filament Version Coverage Status

A Laravel starter kit for Northwestern University applications, with Northwestern sign-in, roles and permissions, auditing, an OAuth-secured API and the University's branding built in.

Documentation  ·  Installation  ·  Changelog

The public landing page, and the sign-in page on a phone The component gallery, and the app panel with its notifications open
The users list, and an audit record of a role assignment Sign-in records, and API request analytics

Overview

Every application needs the same groundwork before it can do anything of its own: sign-in, permissions, auditing, an API, CI, monitoring, and a structure that holds up as it grows. Rebuilding it for each project takes time away from the work that matters, and every team ends up with a slightly different version.

The starter builds it once, tested and documented, so your team starts with the work that's specific to your application.

Important

The starter is built for applications inside Northwestern University's environment: its sign-in and integrations rely on University services. Outside Northwestern, you can still borrow its architecture and patterns.

Getting Started

composer create-project northwestern-sysdev/northwestern-laravel-starter your-project-name
cd your-project-name

Then follow the installation guide to configure your environment and run the application. The documentation covers everything below in full.

What's Included

Northwestern Integrations

  • Single sign-on: NetID sign-in through Online Passport (WebSSO) or Entra ID.
  • Directory Search: Accounts created on first sign-in and kept in sync with the Northwestern Directory.
  • Wildcard photos: People's ID photos, cached.
  • EventHub: Publish events, and receive them through webhooks.

Access and Accountability

  • Sign-in: Single sign-on, emailed codes for partners without a NetID, and impersonation for troubleshooting.
  • Roles and permissions: Managed in the administration panel, given to many people at once from a list or a CSV file, with a history of every change.
  • Audit trail: Changes to your models, and every role, permission and credential event, with the values before and after.
  • Data retention: A retention period for each kind of record, including notifications, imports and the queue's failed jobs, with older records pruned daily.

API and AI Clients

  • OAuth credentials: Service clients for integrations, personal access tokens, and applications people connect through a consent screen, all on Laravel Passport.
  • MCP server: AI clients such as Claude and VS Code use your application's tools as the person who connected them.
  • Operations: Request logs and analytics, trace IDs across logs, audits and errors, and RFC 9457 error responses.

Interface

  • Two Filament panels: An app panel for your application's features, and an administration panel for users, roles, credentials, audits and analytics.
  • Public pages: A landing page, a public changelog, and branded error pages.
  • Announcements and Contact Support: Tell people what's changing, and take their requests as TeamDynamix tickets or email.
  • Northwestern branding: Themed to the University's guidelines, with the unit footer the Web Style Guide requires.
  • Accessibility: Every page the starter ships is checked with axe, in light and dark mode.

Developer Experience

Acknowledgements

Built on Laravel, Filament and many other open-source packages. Thanks to the Laravel community and Northwestern IT.