Skip to content

Conversation

@abovedave
Copy link
Collaborator

Replaces Eleventy for a SvelteKit powered docs site:

  • New docs can be added as .md files in packages/stacks-docs/src/docs/
  • For complex documentation requiring images and interactivity you can also create a folder with an index.md. See /packages/stacks-docs/src/docs/public/brand/typography/ as an example.
  • Navigation is updated by editing packages/stacks-docs/src/structure.yaml
  • ⚠️ In-progress: Migrate old stacks documentation to svelte powered, using stacks-svelte where appropriate. This can be ongoing work as we build out new sections.
  • Upgraded Agolia DocSearch, although now setup with the new structure yet.

To get started:

npm i
npm run dev -w packages/stacks-site

Adds support for gated documentation for employees, this is useful for non-technical folks finding brand or design related information e.g., location of internal presentation decks, brand strategy details.

Employees will need access to StackEng/StacksDocsPrivate and SSH authentication setup when cloning.

git clone -b beta https://github.com/StackExchange/Stacks.git
cd ./Stacks
git submodule update --init --recursive

Change beta to new-ui to test this branch

Signed-off-by: David Longworth <djl@sent.com>
…ew-ui

Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
this should work in gh previews now

Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>

add github link to sidebar

Signed-off-by: David Longworth <djl@sent.com>

improved color guides

Signed-off-by: David Longworth <djl@sent.com>

use stacks

Signed-off-by: David Longworth <djl@sent.com>

simplify theme popover

Signed-off-by: David Longworth <djl@sent.com>

search dark mode

Signed-off-by: David Longworth <djl@sent.com>

status indicator

Signed-off-by: David Longworth <djl@sent.com>

simplify gallery

Signed-off-by: David Longworth <djl@sent.com>

doc style tweaks

Signed-off-by: David Longworth <djl@sent.com>

update private path

Signed-off-by: David Longworth <djl@sent.com>

use markdown

Signed-off-by: David Longworth <djl@sent.com>

fix spacing

Signed-off-by: David Longworth <djl@sent.com>

wip

Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
@netlify
Copy link

netlify bot commented Dec 16, 2025

Deploy Preview for stacks ready!

Name Link
🔨 Latest commit 7917691
🔍 Latest deploy log https://app.netlify.com/projects/stacks/deploys/694584cd59a545000894f7c8
😎 Deploy Preview https://deploy-preview-2102--stacks.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link

netlify bot commented Dec 16, 2025

Deploy Preview for stacks-svelte failed. Why did it fail? →

Name Link
🔨 Latest commit 7917691
🔍 Latest deploy log https://app.netlify.com/projects/stacks-svelte/deploys/694584cc59a545000894f7c6

Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
Signed-off-by: David Longworth <djl@sent.com>
@abovedave
Copy link
Collaborator Author

abovedave commented Dec 20, 2025

Moving this work to alpha branch, will reopen a PR when we are closed to a switchover

@abovedave abovedave closed this Dec 20, 2025
@abovedave abovedave deleted the new-ui branch December 20, 2025 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants