chore: Update scaffold project by colinmurphy · Pull Request #34 · wpengine/faust-scaffold

colinmurphy · 2025-05-13T09:38:43Z

Goal

To update the scaffold templates with best practices and better resources to meet developers where they are at and give them a better start when beginning headless WordPress

Note

See README for screenshots - https://github.com/wpengine/faust-scaffold/blob/3a92bd181d5300fc8f531e177ef5af4cee8803cc/README.md

Overview of changes

README
Multiple Queries
Updated links
Added category link to the header
Added links to the front page
Allowed faustexample.wpengine.com for images
Refactored archive page
- Post list to get more than the title and link
- Created a post link component
- Queried the first 5 blog posts
- Load more to query the next 5 blog posts client side
Added copyright to the footer
Setup prettier and linting
Added footer menu with links
Update README with structure of the project
Screenshots for the README
File Structure for the README

Added queries and fragments Added styling Added front page resources Added styling and excerpts, images to the archive template

…hat post author isn't on every sample blog post from the Faust example.

…tc into the style directory

… README.md

…etch the data server side.

colinmurphy · 2025-05-19T18:24:58Z

@moonmeister

Added those changes to the docs so its ready for re-review. Thanks for the suggestion ❤️

moonmeister · 2025-05-19T20:24:30Z

+    return <>Loading...</>;
+  }
+
+  const siteDataQuery = useFaustQuery(SITE_DATA_QUERY) || {};


ahuseyn · 2025-05-20T12:18:46Z

@colinmurphy also try this:

On dev mode go to the url: http://localhost:3000/example/
Then from the header menu go to "Sample page"

You'll see this error:

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

colinmurphy · 2025-05-20T12:37:01Z

Thanks @moonmeister and @ahuseyn for some really good feedback.

@ahuseyn I can replicate the same issue so will try and fix this too 👍

I will let ye know once this is ready for review.

colinmurphy · 2025-05-20T16:01:33Z

@moonmeister @ahuseyn This is ready for re-review. Thanks again for all the feedback on the PR ❤️

ahuseyn

Just added suggested changes for the Readme headings, sorry couldn't batch those into one commit

ahuseyn · 2025-05-22T09:58:56Z

@colinmurphy I've added some suggestions to the TS scaffold, which could be applied here too.

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

colinmurphy · 2025-05-22T12:21:36Z

Thanks @ahuseyn

I have committed those suggestions and I will apply those to the other PR too so this is ready for another review :)

Thanks again for reviewing this ❤️

chore: change component filenames to PascalCase

WordPress categories were reorganized with a parent "News" category. All existing categories are now children of News, URIs changed to include /news/, "Crypto" was added, "Marketing" removed (no posts). Changes made: 1. queries/MenuQueries.js: - Added parentId and children { nodes { name slug uri } } to categories query for hierarchy support 2. components/Header.js: - Added buildNavItems() to construct hierarchical nav from flat categories (separates top-level from children) - Desktop nav: "News" shows as dropdown with hover-activated submenu listing all child categories (Business, Crypto, Economy, etc.) - Mobile drawer: "News" renders as expandable accordion with toggle button and indented subcategory links - Added ChevronIcon component for dropdown indicators - Updated Header.fragments to include parentId and children 3. styles/header.module.css: - Added .navItem (relative positioning for submenu) - Added .navSubmenu (absolutely-positioned dropdown panel) - Added .navSubmenuLink styles - Added hover-triggered show/hide for desktop submenu - Added .drawerGroup, .drawerGroupToggle, .drawerSublinks, .drawerSublink for mobile accordion - Added .chevron and .chevronOpen for rotation animation 4. wp-templates/front-page.js: - Updated all CATEGORY_MAP URIs with /news/ prefix - Replaced marketing query/key with crypto

Initial update for the README.md

f240b6f

colinmurphy mentioned this pull request May 13, 2025

chore: Update Faust Scaffold with best practices for performance wpengine/hwptoolkit#154

Closed

colinmurphy added 8 commits May 14, 2025 14:13

Setup templates to use multiple queries.

e6be458

Tidy up.

ef4e07d

Major refactor of templates

e9fbb4c

Added queries and fragments Added styling Added front page resources Added styling and excerpts, images to the archive template

Refactored archive template with load more functionality. Small bug t…

a768a7a

…hat post author isn't on every sample blog post from the Faust example.

Setup prettier and ran it to prettify the application.

904a090

Fixed styling for header on mobile. Moved styles for header, footer e…

970d98a

…tc into the style directory

Fixed bug in single post. Added file structure and screenshots to the…

13c61ff

… README.md

Added main query for archive to the multiple queries so Faust could f…

3a92bd1

…etch the data server side.

colinmurphy marked this pull request as ready for review May 16, 2025 19:13

colinmurphy requested a review from a team as a code owner May 16, 2025 19:13

colinmurphy requested review from ahuseyn, moonmeister and theodesp May 16, 2025 19:13

colinmurphy added 2 commits May 16, 2025 21:10

Removed inline styling

8114271

Small style issue

8412b93

theodesp previously approved these changes May 19, 2025

View reviewed changes

Updated docs as per @moonmeister suggestion.

f4dc672

colinmurphy dismissed theodesp’s stale review via f4dc672 May 19, 2025 18:23

colinmurphy requested a review from theodesp May 19, 2025 18:24

moonmeister suggested changes May 19, 2025

View reviewed changes

ahuseyn reviewed May 20, 2025

View reviewed changes

Comment thread README.md Outdated

Comment thread wp-templates/archive.js Outdated

Comment thread next.config.js

colinmurphy and others added 3 commits May 20, 2025 13:35

Update README.md

822a674

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

Update wp-templates/archive.js

2b319c2

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

Update next.config.js

f122abc

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

Small snags - Fixed h1, removed package-lock.json

9db9d5e

Removed Faust Query. Fixed menu issue thanks @ahuseyn and @moonmeister

c776234

colinmurphy requested review from ahuseyn and moonmeister May 20, 2025 16:01

ahuseyn reviewed May 21, 2025

View reviewed changes

Comment thread README.md Outdated

Comment thread README.md Outdated

Comment thread README.md

Comment thread README.md

Comment thread README.md Outdated

Comment thread README.md

Comment thread README.md Outdated

Comment thread README.md Outdated

Comment thread README.md Outdated

ahuseyn mentioned this pull request May 22, 2025

Refactored Faust Scaffold TS wpengine/faust-scaffold-ts#29

Merged

colinmurphy and others added 6 commits May 22, 2025 13:19

Update README.md

c73ce3a

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

Update README.md

5947dfb

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

Update README.md

861db77

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

Update README.md

e214bad

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

Update README.md

98011bb

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

Update README.md

8294553

Co-authored-by: Huseyn Aghayev <husen.agaev@gmail.com>

colinmurphy requested a review from ahuseyn May 23, 2025 14:59

ahuseyn and others added 2 commits May 26, 2025 11:39

chore: change component filenames to PascalCase

9cd6592

Merge pull request #35 from wpengine/change-component-names

f92a921

chore: change component filenames to PascalCase

ahuseyn approved these changes May 26, 2025

View reviewed changes

moonmeister approved these changes Jun 2, 2025

View reviewed changes

colinmurphy merged commit c180598 into main Jun 3, 2025
3 checks passed

colinmurphy deleted the chore-update-scaffold-project branch June 3, 2025 09:24

Conversation

colinmurphy commented May 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Goal

Overview of changes

Uh oh!

colinmurphy commented May 19, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

moonmeister May 19, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ahuseyn commented May 20, 2025

Uh oh!

colinmurphy commented May 20, 2025

Uh oh!

colinmurphy commented May 20, 2025

Uh oh!

ahuseyn left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ahuseyn commented May 22, 2025

Uh oh!

colinmurphy commented May 22, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

colinmurphy commented May 13, 2025 •

edited

Loading

ahuseyn left a comment •

edited

Loading