# procore-oss/blueprinter

Simple, Fast, and Declarative Serialization Library for Ruby

Repository: https://github.com/procore-oss/blueprinter
Canonical: https://ross.abutalabs.com/products/blueprinter
Language: Ruby
License: MIT
License Family: permissive
Topics: ruby, rails, json, serializer, resource-serializer, presenter
Last push: 2026-08-17T12:36:47+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 35, longevity 100
- inputs: {"age_days": 3317, "days_push": 16, "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 1311, forks 114 (observed 2026-08-28T04:04:20.029727+00:00)

## What it is
Blueprinter is a declarative JSON serialization library for Ruby that turns business objects into simple hashes and renders them as JSON. It uses predefined views to shape output for different contexts and is designed as a fast, simple alternative to JBuilder or ActiveModelSerializers in Rails apps.

## Use cases
- serialize ruby objects to json
- replace jbuilder or active model serializers in rails
- define multiple json output views for a model
- render json api responses from activerecord collections
- present only selected fields of a user record as json
- serialize collections of records to json arrays

## When to choose
- you want a simple, fast, declarative serializer for a Ruby or Rails app
- you need view-based control over which fields appear in different API contexts
- you prefer plain Ruby DSL over template-based serializers like JBuilder

## When to avoid
- you need XML or non-JSON output formats
- you want deeply nested, highly dynamic serialization logic that a full presenter layer handles better
- your project is not Ruby/Rails

## Facets
- artifact type: library
- maturity: active
- function: serialization, json
- domain: backend, web-development, apis
- platform: ruby
- tags: serializer, presenter, rails, json-api, views, web-server

## Member repositories
- procore-oss/blueprinter (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:20.029727+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-30T04:49:51.696627+00:00, confidence not recorded.
  - readme: https://github.com/procore-oss/blueprinter (fetched 2026-08-28T04:04:20.029727+00:00, sha f714e393a914)
- Data as of 2026-08-30T08:39:29.467469+00:00.