Internal Development Guide

Codex Website Handoff

This page exists so another Codex session can quickly understand how to work on the local development site without wasting deploy credits or disturbing existing work.

Project Location

C:\Users\SHAKA\Documents\Codex\2026-04-28\what-is-the-other-session-doing\ancestral-egbe-website

Local site: http://127.0.0.1:4322/

Full file guide: CODEX_WEBSITE_HANDOFF.md

Most Important Rule

The user is conserving Netlify deploy credits. Work locally, let the user review, and only push to main after explicit approval.

Git Commit Warning

If Git says it cannot create .git/index.lock, do not keep retrying. First check whether .git/index.lock exists. If it does not exist, this is a Windows permission issue on the .git folder, not a website-code problem.

Test-Path .git\index.lock
icacls ".git" /grant "$($env:USERNAME):(OI)(CI)M" /T

For the current handoff/newsletter update, stage only the handoff files listed in CODEX_WEBSITE_HANDOFF.md. Do not use git add ..

Completion Signal

When a task is done, use a seven-tone PowerShell beep so the user can hear completion while working in another window. Windows controls the actual volume.

[console]::beep(880,180); Start-Sleep -Milliseconds 70
[console]::beep(1040,180); Start-Sleep -Milliseconds 70
[console]::beep(1200,180); Start-Sleep -Milliseconds 70
[console]::beep(1040,180); Start-Sleep -Milliseconds 70
[console]::beep(1320,220); Start-Sleep -Milliseconds 80
[console]::beep(1560,220); Start-Sleep -Milliseconds 80
[console]::beep(1760,300)

Attention Needed Signal

When the assistant is blocked, waiting for permission, or needs user input before continuing, use this lower three-tone pattern. It means the user should look at the chat.

[console]::beep(520,450); Start-Sleep -Milliseconds 160
[console]::beep(520,450); Start-Sleep -Milliseconds 160
[console]::beep(420,650)

Start Local Dev

cd "C:\Users\SHAKA\Documents\Codex\2026-04-28\what-is-the-other-session-doing\ancestral-egbe-website"
$env:ASTRO_TELEMETRY_DISABLED='1'
npm.cmd run dev -- --host 127.0.0.1 --port 4322

Cloudflare Tunnel

If another assistant needs public access to the local dev site, run Astro with --host 0.0.0.0, then run Cloudflare in a second PowerShell window.

cloudflared tunnel --url http://localhost:4322

If the tunnel says the host is not allowed, add the exact trycloudflare.com host to astro.config.mjs under vite.server.allowedHosts.

Common Files

src/components/Navigation.astro for dropdown menus.
src/components/RelatedReading.astro for internal reading paths.
src/data/priest-services.ts for priest service cards and dynamic pages.
src/data/coach-services.ts for coaching service cards.
src/data/lectures.ts for cultural lecture topics.
public/images/library/ for reusable images.

Recent Context

Recent focus article: Why Most People Are Not Speaking to Their Ancestors.

Recent image added to library: public/images/library/tradition-first-step-forward.png.

That image is currently used in Healing Generational Trauma.

Newsletter Context

June newsletter planning lives at docs/JUNE_NEWSLETTER_SITE_UPDATES_2026-05-29.md. It is a living candidate list and should be checked again after the next deploy.

Newer newsletter candidates include the Masonic Ancestral Restoration Manual, Amen/Amun/Olokun/Aum thesis, Spiritual Jurisdiction and Crowns of Kemet, Birth Charts and Incarnation Objective Readings, Eve, Asherah, and the Black Goddess, Black Sparta and African Greece, Ogboni Orientation Manual, Reconciliation and Harmony Ritual, Receiving Eshu / Elegba, and Generational Wealth as Ancestral Responsibility.

Suggested newsletter framing: new cultural doctrine, ancestral practice guides, health coaching pathways, and study manuals. Keep the email selective; feature three to five items and place the rest under "New on the Site."

Newest Word manual file: Masonic-Ancestralization-Program-Polished-v6-with-lesson-plan.docx. Avoid older broken Masonic v2 files unless specifically asked.

Working Style

Keep links selective. Do not create link farms. The best pattern is article to related article, practical guide, one manual, or one service.

Use the site voice: clear, culturally grounded, strong, spiritual, and non-salesy.