/blocks-examples

A set of example custom Blocks.

Primary LanguageTypeScript

GitBub Blocks Examples

The GitHub Blocks app depends on a set of "blocks" that handle how to render files and folders. This repo contains a set of example blocks that can serve as inspiration for you to create your own.

Example blocks

Blocks come in two types: file blocks and folder blocks.

All blocks require an object within package.json to describe their intended use. For example:

{
  "type": "file",
  "title": "CSS block",
  "description": "View selectors in a css file",
  "entry": "/blocks/file-blocks/css.tsx",
  "extensions": ["css"],
  "example_path": "https://github.com/githubnext/blocks-tutorial/blob/main/global.css"
}

👀 Preview these example blocks by going to the Blocks Marketplace!

File blocks

Block name Description Supported extensions
Code Simple block for code all extensions
3D Files 3D model block with Three.js gltf, glb
Css View selectors in a css file css
Excalidraw A drawing/whiteboard block excalidraw
Flat A block for flat data files csv, json
Html Render html html

Folder blocks

Block name Description
Minimap A visualization of your folders and files

Create your own custom blocks

Follow the instructions in our custom blocks template repository.