# nuwave/lighthouse

A framework for serving GraphQL from Laravel

Repository: https://github.com/nuwave/lighthouse
Canonical: https://ross.abutalabs.com/products/nuwave-lighthouse
Homepage: https://lighthouse-php.com
Language: PHP
License: MIT
License Family: permissive
Topics: graphql, laravel, php, lighthouse-php, laravel-graphql
Last push: 2026-07-29T13:04:16+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 95, longevity 100
- inputs: {"age_days": 3748, "days_push": 35, "days_rel": 35, "gap_med": 7.5, "n_releases_24m": 45}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3502, forks 469 (observed 2026-08-28T04:08:07.574598+00:00)

## What it is
Lighthouse is a GraphQL server framework that integrates with Laravel applications, letting you define your API schema using the GraphQL Schema Definition Language with server-side directives. It is optimized for Eloquent, generating efficient database queries from your existing models out of the box.

## Use cases
- serve a graphql api from a laravel app
- build a graphql server on top of eloquent models
- define a graphql schema with sdl and directives
- add pagination and validation to graphql queries
- implement graphql subscriptions and federation in laravel
- migrate a rest laravel api to graphql

## When to choose
- you have a Laravel or Lumen application and want to expose a GraphQL API
- you prefer SDL-first schema definition with directive-based behavior
- you want optimized Eloquent queries generated automatically from GraphQL queries
- you need features like pagination, validation, auth, subscriptions, and federation out of the box

## When to avoid
- your project is not built on Laravel/Lumen
- you prefer a code-first GraphQL schema approach rather than SDL
- you need a GraphQL server in a non-PHP stack
- you want a framework-agnostic GraphQL library

## Facets
- artifact type: framework
- maturity: active
- function: graphql, web-framework, api-framework, orm, middleware, routing
- domain: web-development, backend, apis, databases
- platform: php, self-hosted
- tags: laravel, eloquent, sdl-first, schema-directives, pagination, federation, subscriptions, lumen, web-server

## Member repositories
- nuwave/lighthouse (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:07.574598+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:35:47.772567+00:00, confidence not recorded.
  - readme: https://github.com/nuwave/lighthouse (fetched 2026-08-28T04:08:07.574598+00:00, sha f0a82fb48343)
  - homepage: https://lighthouse-php.com (fetched 2026-08-29T09:29:54.146836+00:00, sha 036c7b64415b)
  - site_page: https://lighthouse-php.com/master/getting-started/installation (fetched 2026-08-29T09:29:54.155928+00:00, sha 99bcf2eb90b2)
  - site_page: https://lighthouse-php.com/6/getting-started/installation (fetched 2026-08-29T09:29:54.157795+00:00, sha 99bcf2eb90b2)
  - site_page: https://lighthouse-php.com/5/getting-started/installation (fetched 2026-08-29T09:29:54.159601+00:00, sha 267b5f4696c0)
  - site_page: https://lighthouse-php.com/4/getting-started/installation (fetched 2026-08-29T09:29:54.161218+00:00, sha b6a2dcbaa995)
  - site_page: https://lighthouse-php.com/3/getting-started/installation (fetched 2026-08-29T09:29:54.162971+00:00, sha d281b77bb3d5)
  - site_page: https://lighthouse-php.com/2/getting-started/installation (fetched 2026-08-29T09:29:54.164542+00:00, sha 57e113513cba)
- Data as of 2026-08-30T08:39:29.467469+00:00.
