# spring-projects/spring-petclinic

A sample Spring-based application

Repository: https://github.com/spring-projects/spring-petclinic
Canonical: https://ross.abutalabs.com/products/spring-petclinic
Language: CSS
License: Apache-2.0
License Family: permissive
Last push: 2026-08-26T10:57:55+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 35, longevity 100
- inputs: {"age_days": 4984, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9482, forks 30423 (observed 2026-08-28T04:10:31.345107+00:00)

## What it is
Spring PetClinic is the official Spring sample application: a Spring Boot web app that manages a veterinary clinic's owners, pets, veterinarians, and visits. It is maintained by the Spring team as a reference example demonstrating idiomatic Spring Boot, Spring MVC, Spring Data JPA, and testing practices.

## Use cases
- learn spring boot through a complete working example
- study a sample spring mvc crud web application
- see how to structure a spring data jpa project with tests
- reference project for spring best practices and conventions
- demo app to try spring tooling like maven, gradle, and container builds
- starting point for practicing spring development locally

## When to choose
- you are learning Spring Boot, Spring MVC, or Spring Data JPA and want a canonical, well-maintained example
- you need a realistic baseline app for demos, tooling evaluation, reproducing bugs, or conference presentations
- you want to study project conventions such as Maven/Gradle builds, layered architecture, tests, and container image builds

## When to avoid
- you need a real veterinary practice management system - this is a demo with an in-memory H2 database and seeded sample data
- you want a production-ready starter with authentication, multi-tenancy, or operational hardening
- your stack is not Java/JVM-based, since the entire example is built around Spring Boot

## Facets
- artifact type: application
- maturity: active
- function: developer-tools, http-server
- domain: web-development, developer-tools, education, tutorials, backend
- platform: jvm, cross-platform
- tags: sample-application, spring-boot, spring, java, reference-app, demo, crud, jpa, thymeleaf, maven, gradle, starter, boilerplate, tutorial, h2-database, web-server, docker

## Member repositories
- spring-projects/spring-petclinic (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:31.345107+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-29T17:22:03.588874+00:00, confidence not recorded.
  - readme: https://github.com/spring-projects/spring-petclinic (fetched 2026-08-28T04:10:31.345107+00:00, sha 784132c86dbb)
- Data as of 2026-08-30T08:39:29.467469+00:00.