Buildfjord

Buildfjord is a GitHub Actions dashboard built to make repository health visible without drowning you in tooling overhead.

It gives you a focused board for the repositories that matter right now, keeps live pipeline signal front and center, and uses a safer server-managed session flow instead of exposing GitHub tokens to browser storage.

If you want a simple way to watch builds across a handful of repositories, this is the point of the project.

Why Buildfjord

• Focused workflow signal instead of a generic CI dashboard
• GitHub OAuth app flow with server-managed sessions
• Local-first development with a clean path toward public deployment
• Live workflow updates, recent run context, and fast failure visibility
• CI, security checks, tests, and repo hygiene already in place

Feature Highlights

• GitHub OAuth sign-in
• Server-managed session cookie for GitHub access
• Searchable repository picker modal
• Tracked repository cards ordered by recent run activity
• Live status streaming for active workflows
• Recent runs per repository
• Failure alerts plus a Needs attention summary
• Responsive layout with desktop and mobile support

Quick Start

Getting Buildfjord running locally is straightforward:

1. Create a GitHub OAuth app

Use this callback URL for local development:

http://localhost:3000/api/auth/github/callback

You can create the app in GitHub Developer Settings.

2. Configure local environment variables

Copy the example file:

cp .env.example .env.local

Then add your real GitHub OAuth credentials to .env.local:

GITHUB_CLIENT_ID=your_real_client_id
GITHUB_CLIENT_SECRET=your_real_client_secret

3. Install and run

npm install
npm run dev

Open http://localhost:3000.

4. Click Login With GitHub

Buildfjord will send you through the GitHub OAuth flow and create a server-managed session when you come back.

Scripts

npm run dev
npm run lint
npm run test
npm run test:watch
npm run security:check
npm run ci:check
npm run build

CI And Security

Buildfjord includes:

• GitHub Actions CI for lint, test, and build
• npm audit enforcement through npm run security:check
• Dependabot configuration for npm and GitHub Actions updates

Project Structure

• src/components for UI components
• src/app/api for auth and GitHub API routes
• src/lib for domain helpers and server session handling
• public for repo and product assets
• .github for CI and repository automation

Deployment Notes

Buildfjord is ready for local use and early deployment:

• MIT licensed
• contributor docs and templates added
• server-side session handling in place
• baseline UI and domain tests in place

The main infrastructure limitation today is the local file-backed session store. It works well for one instance, but it should be replaced with a shared session backend before you run multiple instances.

Things To Know

• The GitHub OAuth app is only needed once per local setup
• The callback URL must match exactly
• Your tracked repository list stays in browser storage for convenience
• Your GitHub token stays on the server side after login

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md.

License

MIT. See LICENSE.