docs(blog): filesystem navigation tips for DDEV projects - #749
Merged
Merged
Conversation
Deploying ddev-com-front-end with
|
| Latest commit: |
11aa15e
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://f2fe3af2.ddev-com-front-end.pages.dev |
| Branch Preview URL: | https://20260930-filesystem-nav.ddev-com-front-end.pages.dev |
rfay
marked this pull request as ready for review
September 30, 2026 14:56
Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: dependabot[bot] <support@github.com>
## The Issue - Fixes #REPLACE_ME_WITH_RELATED_ISSUE_NUMBER Users with many DDEV projects ask how to get to a project directory and open it in an editor without digging through Finder, as in a recent Bluesky thread. ## How This PR Solves The Issue Adds a draft blog post covering `ddev list -A`, the `ddev` dashboard, `ddevcd`, autojump, `code .`, the clickable project location in `ddev st`, and `ddev list -j | jq`, with two screenshots. The feature image, screencast embed, and several sections are still marked with TODO comments. ## Manual Testing Instructions Open the post at `https://REPLACE_ME.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and check the screenshots render. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. Do not publish until the TODO comments, feature image, and screencast are resolved. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
…article ## The Issue - Fixes #REPLACE_ME_WITH_RELATED_ISSUE_NUMBER The draft filesystem navigation article had a placeholder feature image and a TODO in the `code .` section. ## How This PR Solves The Issue Adds an SVG feature image with alt text, and replaces the editor TODO with `cursor .`, `phpstorm .`, `open -a PhpStorm .`, how to install the `code` command, and a combined `ddevcd myproject && ddev start && code .` example. ## Manual Testing Instructions Open the post at `https://REPLACE_ME.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and check the feature image renders. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. The screencast embed and several TODO comments remain. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
## The Issue - Fixes #REPLACE_ME_WITH_RELATED_ISSUE_NUMBER The text captures of `ddev list` and `ddev st` did not show the OSC 8 hyperlinks and were wide for phone screens. ## How This PR Solves The Issue Replaces both text blocks with screenshots taken in a narrower terminal, where the clickable locations and URLs are underlined. ## Manual Testing Instructions Open the post at `https://REPLACE_ME.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and check both screenshots render. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. The screencast embed and several TODO comments remain. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
## The Issue - Fixes #REPLACE_ME_WITH_RELATED_ISSUE_NUMBER The `ddev list -j | jq` examples were single long lines that overflowed the code block and sat under the Copy button. ## How This PR Solves The Issue Splits each `jq` filter across indented lines so every code line is short. The commands produce the same output. ## Manual Testing Instructions Open the post at `https://REPLACE_ME.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and check the Advanced section on a narrow screen. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. The screencast embed and several TODO comments remain. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
## The Issue - Fixes #REPLACE_ME_WITH_RELATED_ISSUE_NUMBER The editor section only showed `code .`, and the hyperlink section did not say which terminals support clickable links. ## How This PR Solves The Issue Retitles the editor section to `code .` or `phpstorm .` with an example and setup steps for each, and adds a combined `ddevcd` example for both. Adds a sentence naming terminals that handle OSC 8 links (iTerm2, Windows Terminal, the default Ubuntu and Fedora terminals, Terminator) and noting that macOS Terminal does not. ## Manual Testing Instructions Open the post at `https://REPLACE_ME.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and read the editor and `ddev describe` sections. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. The screencast embed and several TODO comments remain. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
…ion article ## The Issue - Fixes #REPLACE_ME_WITH_RELATED_ISSUE_NUMBER The dashboard section mentioned filtering only in passing, and the screenshots needed updating. ## How This PR Solves The Issue Adds a screenshot of the dashboard filter and a paragraph on `/`, which matches a project's name, type, status, or directory (case-insensitive). Updates the list, describe, and dashboard screenshots. ## Manual Testing Instructions Open the post at `https://REPLACE_ME.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and check the dashboard section and screenshots. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. The screencast embed and several TODO comments remain. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
## The Issue The navigation article ended with a TODO placeholder instead of a closing section. ## How This PR Solves The Issue Replaces the placeholder with the standard "Contributions welcome!" closing used in other posts, linking to the contributor training post and the newsletter. ## Manual Testing Instructions Open the post preview at `https://20260930-filesystem-nav.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and check the ending and its links. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. The screencast embed and several TODO comments remain. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
## The Issue There were no written steps for producing terminal screenshots or hand-written SVG feature images, and `CLAUDE.md` was only a symlink to `AGENTS.md`. ## How This PR Solves The Issue Adds "Terminal Screenshots" (VHS tape files, last-frame extraction, terminal widths, cropping, hyperlink behavior) and "SVG Feature Images" sections to `AGENTS.md`, and removes the `CLAUDE.md` symlink. ## Automated Testing Overview No automated tests. `ddev prettier` passes. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
## The Issue The clickable links section had no screenshot of links in `ddev list` output. ## How This PR Solves The Issue Adds a `ddev list --active-only` screenshot with the location and URL columns underlined as clickable links, and notes that the URL column links are clickable too. ## Manual Testing Instructions Open the post preview at `https://20260930-filesystem-nav.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and check the new screenshot in the clickable links section. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. The screencast embed and several TODO comments remain. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
## The Issue The clickable links section mixed in `ddev list` content, which already has its own section. ## How This PR Solves The Issue Restores the section title to `ddev describe`, removes the `ddev list` sentence, and deletes the extra `ddev list --active-only` screenshot. ## Manual Testing Instructions Open the post preview at `https://20260930-filesystem-nav.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/` and read the `ddev describe` section. ## Automated Testing Overview No automated tests. `ddev prettier` and `ddev textlint` pass. ## Release/Deployment Notes Draft only. The screencast embed and several TODO comments remain. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
stasadev
approved these changes
Sep 30, 2026
stasadev
left a comment
stasadev
left a comment
Member
There was a problem hiding this comment.
Looks good to me.
I suggest moving the info about clickable links into one "Clickable Links" subsection under ddev list, since that's where the article first mentions them.
Co-authored-by: Stanislav Zhuk <stasadev@gmail.com>
Co-authored-by: Stanislav Zhuk <stasadev@gmail.com>
Co-authored-by: Stanislav Zhuk <stasadev@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The Issue
A recent Bluesky thread asked how to get to a DDEV project directory and open it in an editor without digging through Finder, and how to tell which of dozens of projects are running.
How This PR Solves The Issue
Adds a blog post, "Getting to Your DDEV Projects Fast: Filesystem Navigation Tips", covering
ddev list -A, theddevdashboard and its/filter,ddevcd, autojump,code .andphpstorm ., the clickable project location inddev st, andddev list -j | jq. It includes a feature image (SVG) and four screenshots.The post is a draft. Remaining TODO comments cover the screencast embed (still
REPLACE_ME), theddevcdoutput, the autojump notes, the closing sections, and a check of thecodeexample withjq. Marked as a draft PR for that reason.Manual Testing Instructions
Rendered at https://20260930-filesystem-nav.ddev-com-front-end.pages.dev/blog/navigating-ddev-projects-filesystem/ - Read it there.
Release/Deployment Notes
Do not merge until the TODO comments and the screencast are resolved.
🤖 Generated with Claude Code