Skip to content

failing command for (possibly very small number of) codespaces users - request docs tweak #1189

@Lauro235

Description

@Lauro235

Problem

Codespaces users may find graphQL errors when running commands without &&. the examples in the quick commands reference guide do not include &&.

Broken command (for some codespace users)
FCC_BLOCK='workshop-cat-photo-app' pnpm run clean-and-develop

Working command
FCC_BLOCK='workshop-cat-photo-app' && pnpm run clean-and-develop

Suggestion:

Include note/callout that mentions a possible problem for codespace users when they run the commands without && signs.

================

More Info

================

I am (personally) able to recreate the error failed - createPages which leads to a pathing problem and sends devs to the 404 page not found screen.

Prerequisites:

Use codespaces and follow advice suggested in issue freeCodeCamp/freeCodeCamp#992. This includes changing the codespaces core number to its max (as of writing 4)
Have an up-to-date version of node. This can be achieved using nvm or fnm. I used fnm which is saved on Zsh. This did require editing .devcontainer/devcontainer.json file to

{
  "name": "freeCodeCampDC",
  "dockerComposeFile": "docker-compose.yml",
  "service": "devcontainer",
  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
  "forwardPorts": [3000, 8000],
  "portsAttributes": {
    "3000": {
      "label": "API",
      "onAutoForward": "silent"
    },
    "8000": {
      "label": "Client",
      "onAutoForward": "notify"
    }
  },
  "otherPortsAttributes": {
    "onAutoForward": "silent"
  },
  "onCreateCommand": "[ ! -f .env ] && cp sample.env .env || true",
  "updateContentCommand": "pnpm install && pnpm seed",
  // ~/.local/share/fnm/fnm
  "postCreateCommand": "curl -fsSL https://fnm.vercel.app/install | bash -s -- --install-dir ~/.local/share/fnm --skip-shell && echo 'export PATH=\"$HOME/.local/share/fnm:$PATH\"' >> $HOME/.zshrc && echo 'eval \"$(fnm env --use-on-cd --version-file-strategy=recursive)\"' >> $HOME/.zshrc",
  "postStartCommand": "zsh -c 'fnm install 24.12.0 -- --force && fnm default 24.12.0'",
  "postAttachCommand": {
    "instructions": "bash -c 'echo \"\n Start a new terminal and run \\`pnpm run develop\\` when you are ready.\n\"'"
  }
}

Steps to reproduce

  1. Open zsh.
  2. run fnm use 24.12.0
  3. run FCC_BLOCK='workshop-cat-photo-app pnpm run clean-and-develop'

Here is where I saw the error failed - createPages and the graphQL slug error with the journey to the 404 page.

To correct this I found that running the same command with && fixed the issue

  1. run FCC_BLOCK='workshop-cat-photo-app && pnpm run clean-and-develop'

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No fields configured for Bug.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions