Skip to content

Commit 64f8b4d

Browse files
feat: add SSE streaming API Reference example
Co-Authored-By: Devin Logan <devinannlogan@gmail.com>
1 parent 9618317 commit 64f8b4d

17 files changed

Lines changed: 623 additions & 3 deletions

.github/workflows/check.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ jobs:
1212
strategy:
1313
fail-fast: false
1414
matrix:
15-
project: [docs-starter, graphql, grpc, i18n, multi-source/homepage, multi-source/seeds, multi-source/seeds-sunflower, multi-source/seeds-tomato, multi-source/greenhouses, multi-source/nursery, versioning]
15+
project: [docs-starter, graphql, grpc, i18n, multi-source/homepage, multi-source/seeds, multi-source/seeds-sunflower, multi-source/seeds-tomato, multi-source/greenhouses, multi-source/nursery, sse, versioning]
1616
steps:
1717
- name: Checkout repository
1818
uses: actions/checkout@v4

.github/workflows/preview-docs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ jobs:
3131
FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
3232
PR_NUMBER: ${{ github.event.pull_request.number }}
3333
run: |
34-
PROJECTS="docs-starter graphql grpc i18n multi-source/homepage multi-source/seeds multi-source/seeds-sunflower multi-source/seeds-tomato multi-source/greenhouses multi-source/nursery versioning"
34+
PROJECTS="docs-starter graphql grpc i18n multi-source/homepage multi-source/seeds multi-source/seeds-sunflower multi-source/seeds-tomato multi-source/greenhouses multi-source/nursery sse versioning"
3535
CHANGED_FILES=$(git diff --name-only origin/main...HEAD)
3636
3737
: > comment.md

.github/workflows/publish-docs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ jobs:
1212
strategy:
1313
fail-fast: false
1414
matrix:
15-
project: [docs-starter, graphql, grpc, i18n, multi-source/homepage, multi-source/seeds, multi-source/seeds-sunflower, multi-source/seeds-tomato, multi-source/greenhouses, multi-source/nursery, versioning]
15+
project: [docs-starter, graphql, grpc, i18n, multi-source/homepage, multi-source/seeds, multi-source/seeds-sunflower, multi-source/seeds-tomato, multi-source/greenhouses, multi-source/nursery, sse, versioning]
1616
steps:
1717
- name: Checkout repository
1818
uses: actions/checkout@v4

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Example Fern docs projects. Each top-level folder is a self-contained example wi
1313
| [`grpc`](./grpc) | gRPC API Reference from `.proto` files | [grpc.docs.buildwithfern.com](https://grpc.docs.buildwithfern.com) |
1414
| [`i18n`](./i18n) | Multi-language docs with English + Japanese translations | [i18n.docs.buildwithfern.com](https://i18n.docs.buildwithfern.com) |
1515
| [`multi-source`](./multi-source) | Multi-source docs — six independent projects publishing to one domain with global theme, nested sub-paths, and shared branding | [multi-source.docs.buildwithfern.com](https://multi-source.docs.buildwithfern.com) |
16+
| [`sse`](./sse) | SSE streaming API Reference with `x-fern-streaming` | [sse.docs.buildwithfern.com](https://sse.docs.buildwithfern.com) |
1617
| [`versioning`](./docs-versioned) | Versioned site with a version dropdown and a shared page | [versioning.docs.buildwithfern.com](https://versioning.docs.buildwithfern.com) |
1718

1819
## Use an example

sse/fern/docs.yml

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# yaml-language-server: $schema=https://schema.buildwithfern.dev/docs-yml.json
2+
3+
instances:
4+
- url: sse.docs.buildwithfern.com
5+
6+
title: SSE Docs Example
7+
8+
layout:
9+
searchbar-placement: header
10+
page-width: full
11+
tabs-placement: header
12+
13+
tabs:
14+
home:
15+
display-name: Docs
16+
icon: home
17+
API Reference:
18+
display-name: API Reference
19+
icon: puzzle
20+
21+
navigation:
22+
- tab: home
23+
layout:
24+
- section: Get started
25+
contents:
26+
- page: Welcome
27+
path: docs/pages/welcome.mdx
28+
icon: fa-duotone fa-house
29+
- tab: API Reference
30+
layout:
31+
- section: Overview
32+
contents:
33+
- page: API reference
34+
path: docs/pages/api-reference-overview.mdx
35+
icon: fa-duotone fa-book
36+
- api: Plant Store Streaming API
37+
flattened: true
38+
39+
navbar-links:
40+
- type: minimal
41+
text: Fork this repo
42+
url: https://github.com/fern-api/docs-examples
43+
- type: filled
44+
text: Dashboard
45+
url: https://dashboard.buildwithfern.com
46+
- type: github
47+
value: https://github.com/fern-api/fern
48+
49+
colors:
50+
accent-primary:
51+
dark: "#70E155"
52+
light: "#008700"
53+
background:
54+
dark: "#111113"
55+
light: "#FFFFFF"
56+
57+
theme:
58+
page-actions: toolbar
59+
footer-nav: minimal
60+
61+
logo:
62+
dark: docs/assets/logo-dark.svg
63+
light: docs/assets/logo.svg
64+
height: 20
65+
href: https://buildwithfern.com
66+
67+
favicon: docs/assets/favicon.svg
68+
69+
css: styles.css

sse/fern/docs/assets/favicon.svg

Lines changed: 8 additions & 0 deletions
Loading
Lines changed: 4 additions & 0 deletions
Loading
Lines changed: 4 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)