Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
37c0252
docs: improve documentation structure with unified command chains and…
djm81 Jan 4, 2026
a80e90a
docs: add integrations overview guide (optional task 6.4)
djm81 Jan 4, 2026
5f9d832
docs: fix linting errors in integrations-overview.md
djm81 Jan 4, 2026
0f3e37a
docs: simplify README and add links to new documentation
djm81 Jan 5, 2026
8d4812e
docs: add prominent SpecFact domain links with context
djm81 Jan 5, 2026
b83d16a
docs: update Quick Start with correct IDE setup workflow
djm81 Jan 5, 2026
112b5f9
fix: correct heading level for SpecFact Domains section
djm81 Jan 5, 2026
ae038d6
Merge branch 'main' into dev
djm81 Jan 5, 2026
eb5afa7
docs: fix GitHub Pages permalinks for all documentation pages
djm81 Jan 5, 2026
61968f9
merge: merge main into dev to resolve conflicts
djm81 Jan 5, 2026
f22a011
fix: resolve Jekyll build errors for GitHub Pages
djm81 Jan 5, 2026
fc600ef
merge: merge main into dev, resolve conflict in speckit-journey.md
djm81 Jan 5, 2026
cecc75e
docs: add new pages to GitHub Pages navigation menu
djm81 Jan 5, 2026
a34921a
merge: merge main into dev (no conflicts)
djm81 Jan 5, 2026
105f1e2
docs: add new pages to GitHub Pages sidebar navigation menu
djm81 Jan 5, 2026
366b7c9
merge: merge main into dev (no conflicts)
djm81 Jan 5, 2026
397c38b
feat: add Mermaid.js support for diagram rendering on GitHub Pages
djm81 Jan 5, 2026
40fe620
merge: merge main into dev (no conflicts)
djm81 Jan 5, 2026
bfd7ce2
feat: align GitHub Pages styling with specfact.io design
djm81 Jan 5, 2026
c375ca1
fix: improve YAML and code syntax highlighting for dark theme
djm81 Jan 5, 2026
4ae4eff
feat: update to custom domain docs.specfact.io
djm81 Jan 5, 2026
b2674ec
merge: merge main into dev, resolve conflicts
djm81 Jan 5, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@

<div align="center">

**[🌐 specfact.com](https://specfact.com)** • **[📚 specfact.io](https://specfact.io)** • **[👨‍💻 specfact.dev](https://specfact.dev)** • **[📖 GitHub Pages Docs](https://nold-ai.github.io/specfact-cli/)** • **[💬 Support](mailto:[email protected])**
**[🌐 specfact.com](https://specfact.com)** • **[📚 specfact.io](https://specfact.io)** • **[👨‍💻 specfact.dev](https://specfact.dev)** • **[📖 Documentation](https://docs.specfact.io/)** • **[💬 Support](mailto:[email protected])**

</div>

Expand All @@ -21,7 +21,7 @@
- **[specfact.com](https://specfact.com)** - Commercial landing page (marketing, pricing, enterprise)
- **[specfact.io](https://specfact.io)** - Product ecosystem hub (CLI reference, integrations, changelog, product docs)
- **[specfact.dev](https://specfact.dev)** - Developer community (tutorials, guides, blog, community content) ⭐ **For developers**
- **[GitHub Pages Docs](https://nold-ai.github.io/specfact-cli/)** - Complete online documentation
- **[docs.specfact.io](https://docs.specfact.io/)** - Complete online documentation

---

Expand Down Expand Up @@ -233,7 +233,7 @@ specfact import from-code my-project --repo .
- **[DevOps Adapter Integration](docs/guides/devops-adapter-integration.md)** - GitHub Issues, Linear, Jira

👉 **[Full Documentation Index](docs/README.md)** - Browse all documentation
👉 **[GitHub Pages Documentation](https://nold-ai.github.io/specfact-cli/)** - Online documentation site
👉 **[Online Documentation](https://docs.specfact.io/)** - Complete documentation site

---

Expand Down
19 changes: 13 additions & 6 deletions docs/_config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
title: SpecFact CLI Documentation
description: >-
Complete documentation for SpecFact CLI - Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts.
baseurl: "/specfact-cli" # Project pages require baseurl
url: "https://nold-ai.github.io" # GitHub Pages domain
baseurl: "" # Custom domain at root, no baseurl needed
url: "https://docs.specfact.io" # Custom domain

# Build settings
markdown: kramdown
Expand Down Expand Up @@ -36,7 +36,6 @@ exclude:
- scripts
- specs
- resources
- "*.css.map" # Exclude source map files

# Source and destination (Jekyll will look for files in docs/)
# Note: For GitHub Pages, Jekyll typically expects source in root or docs/
Expand All @@ -46,13 +45,21 @@ destination: _site

# Defaults
defaults:
# Apply permalink pattern only to markdown pages
# Note: Assets (SCSS files) are not pages, so they won't be affected by this
# Default layout for all pages
- scope:
path: ""
type: pages
values:
layout: default
# Apply permalink pattern only to markdown files (exclude assets)
# Note: SCSS files with front matter are treated as pages and inherit this pattern
# We exclude assets/ directory to prevent CSS from being output at main/index.css
- scope:
path: ""
type: pages
exclude:
- "assets/**"
values:
permalink: /:basename/
- scope:
path: "getting-started"
Expand Down Expand Up @@ -89,7 +96,7 @@ minima:
# sass_dir is only needed for custom SASS partials directory
sass:
style: compressed
sourcemap: never # Disable source maps to avoid conflicts
sourcemap: never # Disable source maps to prevent JSON output

# Footer
footer:
Expand Down
59 changes: 56 additions & 3 deletions docs/_layouts/default.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
{% seo %}
<!-- Fonts -->
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="{{ '/assets/main.css' | relative_url }}">
<link rel="alternate" type="application/rss+xml" title="{{ site.title | escape }}" href="{{ '/feed.xml' | relative_url }}">
{% if jekyll.environment == 'production' and site.google_analytics %}
Expand Down Expand Up @@ -34,12 +38,61 @@
}
});

// Initialize Mermaid after converting all blocks
// Initialize Mermaid with dark theme matching specfact.io colors
mermaid.initialize({
startOnLoad: true,
theme: 'default',
theme: 'dark',
securityLevel: 'loose',
flowchart: { useMaxWidth: true }
flowchart: {
useMaxWidth: true,
htmlLabels: true,
curve: 'basis'
},
themeVariables: {
darkMode: true,
primaryColor: '#64ffda',
primaryTextColor: '#ccd6f6',
primaryBorderColor: '#64ffda',
lineColor: '#64ffda',
secondaryColor: '#112240',
tertiaryColor: '#1d2d50',
background: '#0a192f',
mainBkgColor: '#112240',
secondBkgColor: '#1d2d50',
textColor: '#ccd6f6',
border1: '#64ffda',
border2: '#8892b0',
noteBkgColor: '#1d2d50',
noteTextColor: '#ccd6f6',
noteBorderColor: '#64ffda',
actorBorder: '#64ffda',
actorBkg: '#112240',
actorTextColor: '#ccd6f6',
actorLineColor: '#64ffda',
labelBoxBkgColor: '#112240',
labelBoxBorderColor: '#64ffda',
labelTextColor: '#ccd6f6',
loopTextColor: '#ccd6f6',
activationBorderColor: '#64ffda',
activationBkgColor: '#1d2d50',
sequenceNumberColor: '#0a192f',
sectionBkgColor: '#1d2d50',
altBkgColor: '#112240',
critBkgColor: '#1d2d50',
doneBkgColor: '#64ffda',
doneBorderColor: '#64ffda',
taskBorderColor: '#64ffda',
taskBkgColor: '#112240',
taskTextLightColor: '#ccd6f6',
taskTextColor: '#ccd6f6',
taskTextDarkColor: '#0a192f',
taskTextOutsideColor: '#ccd6f6',
taskTextClickableColor: '#64ffda',
activeTaskBorderColor: '#64ffda',
activeTaskBkgColor: '#1d2d50',
gridColor: '#8892b0',
critBorderColor: '#64ffda'
}
});
});
</script>
Expand Down
Loading
Loading