_config.yml - Jekyll configuration with collections, plugins, navigationGemfile - Ruby dependencies (Jekyll 4.3, plugins).github/workflows/jekyll.yml - GitHub Actions deployment workflowCNAME - Custom domain configuration (seaforge.gspeedai.com)robots.txt - SEO configuration.gitignore - Build artifacts exclusion_layouts/default.html - Base layout with header/footer_layouts/spec.html - ADR/PRD/SDS specification layout_layouts/doc.html - Documentation/handbook layout_includes/header.html - Site header with navigation, search, theme toggle_includes/footer.html - Site footer with links and infoindex.html - Homepage with hero, pillars, features_pages/architecture.md - Architecture overview and ADR index_pages/specifications.md - Spec types index (ADR/PRD/SDS)_pages/documentation.md - Documentation hub_pages/governance.md - Governance and compliance_pages/community.md - Community, contributing, license404.html - Custom 404 pageassets/css/main.css - Base styles with CSS variablesassets/css/components.css - Component-specific stylesassets/js/main.js - Interactive features (search, theme, copy buttons)search.json - Lunr.js search index generatorREADME.md - Complete setup and usage guidesetup.sh - Automated setup script1
2
3
4
5
6
7
8
9
Push to main (docs/** changes)
↓
GitHub Actions triggers
↓
Jekyll build (Ruby 3.3, Jekyll 4.3)
↓
Deploy to gh-pages branch
↓
Serve via seaforge.gspeedai.com
1
2
3
4
cd docs
bundle install
bundle exec jekyll serve --livereload
# → http://localhost:4000
Set up CNAME record at your DNS provider:
1
2
3
4
Type: CNAME
Name: seaforge
Value: sprime01.github.io
TTL: 3600
Collections need to be populated by symlinking or copying from docs/specs/:
1
2
3
4
5
6
7
# Example structure
docs/_adrs/
→ symlink to docs/specs/shared/adr/*.md
docs/_prds/
→ symlink to docs/specs/*/prd/*.md
docs/_sds/
→ symlink to docs/specs/*/sds/*.md
Alternatively, create a script to copy specs with proper frontmatter.
Add to docs/assets/images/:
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
docs/
├── _config.yml # Jekyll config
├── Gemfile # Ruby dependencies
├── CNAME # Custom domain
├── robots.txt # SEO
├── setup.sh # Setup script
├── README.md # Documentation
├── index.html # Homepage
├── 404.html # 404 page
├── search.json # Search index
├── _layouts/ # Page templates
│ ├── default.html
│ ├── spec.html
│ └── doc.html
├── _includes/ # Reusable components
│ ├── header.html
│ └── footer.html
├── _pages/ # Static pages
│ ├── architecture.md
│ ├── specifications.md
│ ├── documentation.md
│ ├── governance.md
│ └── community.md
├── assets/
│ ├── css/
│ │ ├── main.css
│ │ └── components.css
│ ├── js/
│ │ └── main.js
│ └── images/ # (to be populated)
└── .gitignore
Collections (to be populated):
├── _adrs/ # Architecture decisions
├── _prds/ # Product requirements
├── _sds/ # Software designs
├── _handbooks/ # In-depth guides
└── _howto/ # Step-by-step guides
| Component | Technology |
|---|---|
| Generator | Jekyll 4.3 |
| Ruby | 3.3+ |
| Markdown | Kramdown (GFM) |
| Syntax Highlighting | Rouge |
| Diagrams | Mermaid.js |
| Search | Lunr.js |
| Hosting | GitHub Pages |
| Deployment | GitHub Actions |
| Domain | seaforge.gspeedai.com |
✅ Follows all recommendations from the questionnaire ✅ GitHub Actions build (full plugin support) ✅ Modern Jekyll 4.3 + Ruby 3.3 ✅ Lunr.js search ✅ Collections-based structure ✅ Dark mode default ✅ Mermaid diagrams ✅ Spec cross-reference support ✅ Custom domain ready ✅ SEO optimized ✅ Performance optimized
Status: Ready for content migration and DNS configuration Estimated Setup Time: 15 minutes (Ruby installed) + DNS propagation Maintenance: Automated via GitHub Actions