Hesed Phase 4 — Setup Guide

This project keeps the existing homepage design and adds a low-maintenance Insights publishing system.

What is included

• Existing index.html homepage, visually unchanged
• /insights/ article library
• Category pages
• Search
• Premium article template
• Reading time, related articles, sharing, author card and booking CTA
• Article SEO, Open Graph, canonical links and Article schema
• Automatically generated sitemap
• Pages CMS configuration in .pages.yml

A. Upload this project to GitHub

1. Open your private repository: hesed-psychotherapy-website.
2. Choose Add file → Upload files.
3. Upload the contents inside this project folder, not the outer folder itself.
4. Confirm that .eleventy.js, .pages.yml, package.json, index.html, and src are visible at the repository root.
5. Commit to the main branch.

For large uploads, GitHub Desktop is easier: clone the repository, copy all project files into it, then commit and push.

B. Connect the repository to Cloudflare Pages

Because your current Cloudflare site was created through direct upload, the safest migration is to create a temporary Git-connected Pages project first.

1. Cloudflare → Workers & Pages → Create → Pages → Connect to Git.
2. Select the private GitHub repository.
3. Production branch: main.
4. Framework preset: Eleventy (or None).
5. Build command: npm run build.
6. Build output directory: _site.
7. Root directory: leave blank.
8. Environment variable if requested: NODE_VERSION = 22.
9. Deploy.
10. Test the temporary pages.dev URL, especially /, /insights/, the sample article, and /sitemap.xml.

Do not move hesedpsychotherapy.com until the temporary site is fully tested.

C. Connect Pages CMS

1. Visit https://app.pagescms.org/ and sign in with GitHub.
2. Grant Pages CMS access to the private hesed-psychotherapy-website repository.
3. Open that repository inside Pages CMS.
4. It will read .pages.yml and display Articles.
5. Click New Articles, fill in the fields, and save.
6. Saving commits the Markdown file to GitHub. Cloudflare then rebuilds automatically.

D. Publishing an article

1. Article title
2. URL slug, e.g. empty-chair-technique
3. Publication date
4. Category
5. Short summary
6. Optional cover image and image description
7. Article body
8. Keep Save as draft off when ready
9. Save

The public URL becomes:

https://hesedpsychotherapy.com/insights/empty-chair-technique/

E. Final domain switch after testing

Once the temporary Pages project is confirmed:

1. Remove the custom domain from the old direct-upload Pages project.
2. Add hesedpsychotherapy.com to the new Git-connected Pages project.
3. Cloudflare will update the route/DNS association.
4. Confirm the homepage and Insights section.
5. Submit the updated sitemap in Google Search Console: https://hesedpsychotherapy.com/sitemap.xml.

Important

Do not delete the old Cloudflare project until the new Git-connected version is live and verified.