Skip to content

docs(misc): add base astro setup for docs #32058

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 20 commits into from
Jul 24, 2025
Merged

docs(misc): add base astro setup for docs #32058

merged 20 commits into from
Jul 24, 2025

Conversation

jaysoo
Copy link
Member

@jaysoo jaysoo commented Jul 23, 2025

Add the base docs website built with Astro.

barbados-clemens and others added 17 commits July 23, 2025 14:45
unhoist and update configs

add basic docs

rm blog

attempt using tailwind

more experiments

low key ai kind of did it?

just don't look at the code it wrote fo real

minor progress

some progress but doesn't look like it

half way working with old impl script parsing

I don't like having to generate scripts this way, since it requires
build native code first, to then be able to load the nx ts files to then
parse their output. it's the same system we have today and creates lots
of jank and slow pipelines. at least there is the manifest generation
step removed, but still

small tweaks

cleanup

init plugin docs generator script

more tweaks

executors

migrations

nx format

init starlight

feat: configure Astro Starlight with Nx branding

feat: migrate getting-started documentation

feat: migrate nx-cloud-cli documentation

feat: migrate static assets

feat: add content collections configuration

feat: implement CLI documentation loader

feat: implement plugin documentation loader

feat: update build configuration and add component placeholders

docs: add migration summary documenting completed work

nx format

attempting generation port

fix: update loader paths to access main Nx repository and remove placeholders

save state

idk something wip

add netlify

semi working

some progress

generating content

auto make sidebar for api docs

toc

link headers

subprocessor bc jank

add cli docs

add sub pieces to sidebar

custom sidebar

semi working sidebar

wip

plugins back

sidebar cleanup

sidebar testing

nx-cli astro comp

hoist packages to root

remove old sidebar cmp

some cleanup

attempt markdoc

use mdoc for now, but I don't like it

wip

slowlying getting devkit working

content rendering

wip

barebones devkit gen

sync lock
webinars current take multiple places to edit so instead centrialize it
in a collection to be used throughout the project. tbh this isn't really
'webinar' specific but probs should be something along the lines of
'banners.json' or another notification wide system we want in the docs
i.e. confs, new releases, webinars, etc. and leverage the `tags` or
`type` field to make selections as needed for different UI elements.
tutorial kit is using an older version of astro which pulled in an
conflicting peer version of expressive-code. so just drop them since
they're not planning on being released anytime soon and and then do not
pin expressive code and leave it open for astro to grab it's defined
version
wip

wip
@jaysoo jaysoo requested review from FrozenPandaz, vsavkin and a team as code owners July 23, 2025 19:33
Copy link

vercel bot commented Jul 23, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
nx-dev ✅ Ready (Inspect) Visit Preview Jul 24, 2025 4:19pm

@jaysoo jaysoo changed the title Poc beta docs docs(misc): add base astro setup for docs Jul 23, 2025
Copy link
Contributor

nx-cloud bot commented Jul 23, 2025

View your CI Pipeline Execution ↗ for commit c1c0af1

Command Status Duration Result
nx affected --targets=lint,test,build,e2e,e2e-c... ✅ Succeeded 47m 19s View ↗
nx run-many -t check-imports check-commit check... ✅ Succeeded 1m 42s View ↗
nx-cloud record -- nx-cloud conformance:check ✅ Succeeded 2s View ↗
nx-cloud record -- nx format:check ✅ Succeeded 8s View ↗
nx-cloud record -- nx sync:check ✅ Succeeded 6s View ↗
nx documentation ✅ Succeeded 5m 39s View ↗

☁️ Nx Cloud last updated this comment at 2025-07-24 16:44:31 UTC

@jaysoo jaysoo merged commit 82690be into master Jul 24, 2025
5 checks passed
@jaysoo jaysoo deleted the poc-beta-docs branch July 24, 2025 16:55
Copy link

This pull request has already been merged/closed. If you experience issues related to these changes, please open a new issue referencing this pull request.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Jul 30, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants