builtfast.dev/_config.yml at main · built-fast/builtfast.dev · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
# Site settings
url: https://builtfast.dev

title: BuiltFast Developers
description: >
  Open source tools, technical writing, and API documentation
  from BuiltFast.
timezone: 'America/New_York'

# GitHub metadata (explicit for GHA builds)
github:
  default_branch: main

analytics:
  google: G-4WXX1X23X3

# Author/organization
author:
  name: BuiltFast
  url: https://builtfast.com

# Social/SEO
social:
  name: BuiltFast Developers
  links:
    - https://github.com/built-fast
    - https://linkedin.com/company/builtfast

twitter:
  card: summary_large_image

# Feed configuration
feed:
  path: /feed.xml
  posts_limit: 20

# Plugin settings
markdown: kramdown
kramdown:
  input: GFM
  hard_wrap: false
  syntax_highlighter: rouge

# Permalink settings
permalink: '/blog/:title/'

# Pagination settings
pagination:
  enabled: true
  per_page: 9
  permalink: '/page:num/'
  title: 'Page :num'
  sort_reverse: true

# Collections
collections:
  changelog:
    output: true
    permalink: /changelog/:path/
  docs:
    output: true
    permalink: /docs/:path/
  oss:
    output: true
    permalink: /oss/:path/
  people:
    output: false
    permalink: /team/:name/

# Default frontmatter
defaults:
  - scope:
      path: ""
    values:
      image: /assets/images/opengraph.png
      height: 1200
      width: 630
      alt: BuiltFast Developers Logo
  - scope:
      path: ""
      type: "changelog"
    values:
      layout: "changelog-entry"
      excerpt_separator: "<!--more-->"
  - scope:
      path: ""
      type: "docs"
    values:
      layout: "doc"
  - scope:
      path: ""
      type: "oss"
    values:
      layout: "oss"
  - scope:
      path: ""
      type: "posts"
    values:
      layout: "post"
      tags:
        - general

# Files to exclude
exclude:
  - .tags
  - CNAME
  - Gemfile
  - Gemfile.lock
  - README.md
  - LICENSE
  - CLAUDE.md
  - bin
  - vendor/bundle
  - node_modules
  - package.json
  - package-lock.json
  - script
  - _mockup.html

# Redirect settings
redirect_from:
  layout: redirect
  json: false

# Gems
plugins:
  - jekyll-feed
  - jekyll-github-metadata
  - jekyll-lucide
  - jekyll-paginate-v2
  - jekyll-redirect-from
  - jekyll-seo-tag
  - jekyll-sitemap
  - jekyll-tailwind

# Lucide icons
lucide:
  defaults:
    class: "lucide-icon"

# Tailwind configuration
tailwind:
  input: "assets/css/app.css"
  output: "_site/assets/css/app.css"
  minify: true

# Enable drafts
# show_drafts: true

# API Docs configuration
#
# Groups and subgroups use the same ordering pattern:
# - Listed items appear in the order specified
# - "*" is a wildcard that catches unlisted items (sorted alphabetically)
# - If "*" is omitted, unlisted items appear at the end alphabetically
#
# All endpoints will appear regardless of config - ordering just controls
# where they show up. Better to be annoyed by placement than miss something.
api_docs:
  # Main group ordering
  order:
    - Account
    - PHP Versions
    - Sites
    - Environments
    - "*"
  # Subgroup ordering per group (optional - defaults to alphabetical)
  # subgroups:
  #   Sites:
  #     - Overview
  #     - "*"