PHPackages                             ohseesoftware/oh-see-gists - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ohseesoftware/oh-see-gists

ActiveStatamic-addon[Utility & Helpers](/categories/utility)

ohseesoftware/oh-see-gists
==========================

A Statamic v3 add-on to use GitHub's Gists to host code blocks.

v3.2.0(4y ago)43253[2 PRs](https://github.com/ohseesoftware/oh-see-gists/pulls)MITPHPCI failing

Since May 18Pushed 2y ago1 watchersCompare

[ Source](https://github.com/ohseesoftware/oh-see-gists)[ Packagist](https://packagist.org/packages/ohseesoftware/oh-see-gists)[ RSS](/packages/ohseesoftware-oh-see-gists/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (9)Versions (12)Used By (0)

Oh See Gists
============

[](#oh-see-gists)

[![Current Release](https://camo.githubusercontent.com/b9e06d6087fbde6f4ffbad9c737547bcdb1f18bf4796da0645749f393234defe/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6f68736565736f6674776172652f6f682d7365652d67697374732e7376673f7374796c653d666c61742d737175617265)](https://github.com/ohseesoftware/oh-see-gists/releases)[![Build Status Badge](https://github.com/ohseesoftware/oh-see-gists/workflows/Build/badge.svg)](https://github.com/ohseesoftware/oh-see-gists/workflows/Build/badge.svg)[![Coverage Status](https://camo.githubusercontent.com/1d6d2a787c98a2935050ca8506e735ce0061e5078215a5cefe7fdadd3b7c7e83/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6f68736565736f6674776172652f6f682d7365652d67697374732f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/ohseesoftware/oh-see-gists?branch=master)[![Maintainability Score](https://camo.githubusercontent.com/a513b50537b8ce42375894d43e8ca1f61c9ec1dfc89d9debc6707f933e1648a7/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636c696d6174652f6d61696e7461696e6162696c6974792f6f68736565736f6674776172652f6f682d7365652d67697374732e7376673f7374796c653d666c61742d737175617265)](https://codeclimate.com/github/ohseesoftware/oh-see-gists)[![Downloads](https://camo.githubusercontent.com/f8831391c5f91b1b7ecfbde9d54972c16bd29f4dace25115628acc7e8fce8d0b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f68736565736f6674776172652f6f682d7365652d67697374732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ohseesoftware/oh-see-gists)[![MIT License](https://camo.githubusercontent.com/1894f73b5ae9f463f4d8eb9c5fa8200e0d592c3896c1b37fc8e0e057c0eb3e7c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6f68736565736f6674776172652f6f682d7365652d67697374732e7376673f7374796c653d666c61742d737175617265)](https://github.com/ohseesoftware/oh-see-gists/blob/master/LICENSE)

Use GitHub Gists to embed your code snippets on your site. Example:

Installation
------------

[](#installation)

Install the add-on:

`composer require ohseesoftware/oh-see-gists`

Publish the add-on's assets:

`php artisan vendor:publish --tag=oh-see-gists`

This will publish:

- a config file for the GitHub API
- views in the `resources/views` directory
- fieldsets in the `resources/fieldsets` directory

Usage
-----

[](#usage)

### Add your GitHub token to your .env file

[](#add-your-github-token-to-your-env-file)

You'll need to create a new personal access token. You can do so here: .

The token only needs the `gist` scope.

Add the token as `OH_SEE_GISTS_GITHUB_TOKEN` in your `.env` file.

### Add the fieldset to your blueprint(s)

[](#add-the-fieldset-to-your-blueprints)

The fieldset that will be published is named `gist_block`. You will need to update your blueprints to reference the fieldset wherever you want it to be used. As an example in bard:

```
type: bard
sets:
  gist_content:
    display: Gist
    fields:
      - import: gist_block
```

### Naming

[](#naming)

There are two **very important** naming conventions you have to follow:

- The `gist_content` name for the fieldset is **very** important. The add-on references this key so you cannot change it.
- Your bard block has to be named `content` for the add-on to save to your GitHub Gists. Otherwise, you will be just creating code blocks on your Statamic site.

### Use the partial in your templates

[](#use-the-partial-in-your-templates)

The add-on publishes a partial for you to use in your templates to render the Gists. You can use it like so:

```
{{ bard_content }}
    {{ if type == "gist_content" }}
        {{ partial src="partials/gist_content" }}
    {{ /if }}
{{ /bard_content }}
```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 63.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Recently: every ~46 days

Total

11

Last Release

1791d ago

Major Versions

v1.2.1 → v2.0.02020-12-13

v2.1.0 → v3.0.02021-03-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/0dafcec0352ac1a4de72f679bf2c72752d967bd388ec4e9c186142738993b945?d=identicon)[owenconti](/maintainers/owenconti)

---

Top Contributors

[![owenconti](https://avatars.githubusercontent.com/u/791222?v=4)](https://github.com/owenconti "owenconti (23 commits)")[![duncanmcclean](https://avatars.githubusercontent.com/u/19637309?v=4)](https://github.com/duncanmcclean "duncanmcclean (9 commits)")[![ChristopherDosin](https://avatars.githubusercontent.com/u/8193345?v=4)](https://github.com/ChristopherDosin "ChristopherDosin (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")[![tjefford](https://avatars.githubusercontent.com/u/2631747?v=4)](https://github.com/tjefford "tjefford (1 commits)")

---

Tags

gistsstatamicstatamic-addonstatamic-v3

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/ohseesoftware-oh-see-gists/health.svg)

```
[![Health](https://phpackages.com/badges/ohseesoftware-oh-see-gists/health.svg)](https://phpackages.com/packages/ohseesoftware-oh-see-gists)
```

###  Alternatives

[pocketmine/pocketmine-mp

A server software for Minecraft: Bedrock Edition written in PHP

3.5k74.6k86](/packages/pocketmine-pocketmine-mp)[statamic/seo-pro

65440.7k](/packages/statamic-seo-pro)[jacksleight/statamic-bard-texstyle

17172.5k](/packages/jacksleight-statamic-bard-texstyle)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

2381.5k10](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo

Save time and get your Statamic site to rank better with the SEO addon for Statamic.

13128.3k](/packages/withcandour-aardvark-seo)[alt-design/alt-sitemap

Alt Sitemap addon, create a sitemap from Statamic entries

1219.0k](/packages/alt-design-alt-sitemap)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)