FossilRepo

Document feature flags in administration guide; update docs author

ragelink 2026-04-14 04:56 UTC trunk

Commit 218d16ded33b84c86ce5fe6384f3a854e7ee6a8c5df25cc1a9f9c4b296de1304

Parent f4111a3d4c048ff…

2 files changed +18 +2 -2

~ docs/getting-started/administration.md ~ mkdocs.yml

M docs/getting-started/administration.md

+18

		--- docs/getting-started/administration.md
		+++ docs/getting-started/administration.md
		@@ -96,10 +96,28 @@
96	96	- Advanced permission management
97	97	- Data import/export
98	98
99	99	Most day-to-day operations should be done through the main UI, not Super Admin.
100	100
	101	+## Feature Flags
	102	+
	103	+Feature flags let you enable or disable optional functionality at runtime without redeploying. All flags default to off so you can ship a minimal install and turn things on as you need them.
	104	+
	105	+Navigate to Super Admin → Constance → Config (or `/admin/constance/config/`) and look for the Features section.
	106	+
	107	+\| Flag \| What it enables \|
	108	+\|---\|---\|
	109	+\| `FEATURE_CHAT` \| Per-project chat rooms — real-time messaging backed by HTMX polling \|
	110	+\| `FEATURE_RELEASES` \| Releases tab — tag-based releases with downloadable assets and source archives \|
	111	+\| `FEATURE_SYNC` \| Sync tab — Git mirror configuration (GitHub/GitLab OAuth, push/pull schedules) \|
	112	+\| `FEATURE_FILES` \| Files tab — unversioned file storage attached to a project (like GitHub release assets but not version-controlled) \|
	113	+
	114	+Changes take effect immediately — no restart needed.
	115	+
	116	+!!! tip "Recommended starting point"
	117	+ Enable `FEATURE_RELEASES`, `FEATURE_SYNC`, and `FEATURE_FILES` once your instance is stable. Leave `FEATURE_CHAT` off until you need it — the model and routes are present but hidden.
	118	+
101	119	## Project Settings
102	120
103	121	Each project has its own settings tab (visible to project admins):
104	122
105	123	### Repository Info
106	124

	--- docs/getting-started/administration.md
	+++ docs/getting-started/administration.md
	@@ -96,10 +96,28 @@
96	- Advanced permission management
97	- Data import/export
98
99	Most day-to-day operations should be done through the main UI, not Super Admin.
100


















101	## Project Settings
102
103	Each project has its own settings tab (visible to project admins):
104
105	### Repository Info
106

	--- docs/getting-started/administration.md
	+++ docs/getting-started/administration.md
	@@ -96,10 +96,28 @@
96	- Advanced permission management
97	- Data import/export
98
99	Most day-to-day operations should be done through the main UI, not Super Admin.
100
101	## Feature Flags
102
103	Feature flags let you enable or disable optional functionality at runtime without redeploying. All flags default to off so you can ship a minimal install and turn things on as you need them.
104
105	Navigate to Super Admin → Constance → Config (or `/admin/constance/config/`) and look for the Features section.
106
107	\| Flag \| What it enables \|
108	\|---\|---\|
109	\| `FEATURE_CHAT` \| Per-project chat rooms — real-time messaging backed by HTMX polling \|
110	\| `FEATURE_RELEASES` \| Releases tab — tag-based releases with downloadable assets and source archives \|
111	\| `FEATURE_SYNC` \| Sync tab — Git mirror configuration (GitHub/GitLab OAuth, push/pull schedules) \|
112	\| `FEATURE_FILES` \| Files tab — unversioned file storage attached to a project (like GitHub release assets but not version-controlled) \|
113
114	Changes take effect immediately — no restart needed.
115
116	!!! tip "Recommended starting point"
117	Enable `FEATURE_RELEASES`, `FEATURE_SYNC`, and `FEATURE_FILES` once your instance is stable. Leave `FEATURE_CHAT` off until you need it — the model and routes are present but hidden.
118
119	## Project Settings
120
121	Each project has its own settings tab (visible to project admins):
122
123	### Repository Info
124

M mkdocs.yml

+2 -2

		--- mkdocs.yml
		+++ mkdocs.yml
		@@ -1,9 +1,9 @@
1	1	site_name: Fossilrepo
2	2	site_url: https://fossilrepo.dev
3	3	site_description: Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting
4		-site_author: CONFLICT LLC
	4	+site_author: Leo Mata & CONFLICT LLC
5	5	repo_url: https://github.com/ConflictHQ/fossilrepo
6	6	repo_name: ConflictHQ/fossilrepo
7	7
8	8	theme:
9	9	name: material
		@@ -90,6 +90,6 @@
90	90	name: Fossil Repository (primary)
91	91	- icon: fontawesome/brands/github
92	92	link: https://github.com/ConflictHQ/fossilrepo
93	93	name: GitHub Mirror
94	94
95		-copyright: Copyright © 2026 CONFLICT LLC
	95	+copyright: Copyright © 2026 Leo Mata & CONFLICT LLC
96	96

	--- mkdocs.yml
	+++ mkdocs.yml
	@@ -1,9 +1,9 @@
1	site_name: Fossilrepo
2	site_url: https://fossilrepo.dev
3	site_description: Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting
4	site_author: CONFLICT LLC
5	repo_url: https://github.com/ConflictHQ/fossilrepo
6	repo_name: ConflictHQ/fossilrepo
7
8	theme:
9	name: material
	@@ -90,6 +90,6 @@
90	name: Fossil Repository (primary)
91	- icon: fontawesome/brands/github
92	link: https://github.com/ConflictHQ/fossilrepo
93	name: GitHub Mirror
94
95	copyright: Copyright © 2026 CONFLICT LLC
96

	--- mkdocs.yml
	+++ mkdocs.yml
	@@ -1,9 +1,9 @@
1	site_name: Fossilrepo
2	site_url: https://fossilrepo.dev
3	site_description: Self-hosted Fossil forge -- omnibus installer for production Fossil SCM hosting
4	site_author: Leo Mata & CONFLICT LLC
5	repo_url: https://github.com/ConflictHQ/fossilrepo
6	repo_name: ConflictHQ/fossilrepo
7
8	theme:
9	name: material
	@@ -90,6 +90,6 @@
90	name: Fossil Repository (primary)
91	- icon: fontawesome/brands/github
92	link: https://github.com/ConflictHQ/fossilrepo
93	name: GitHub Mirror
94
95	copyright: Copyright © 2026 Leo Mata & CONFLICT LLC
96

FossilRepo

Keyboard Shortcuts