Publishing blog posts

With the editor

Open /admin on the live site and choose Sign in with GitHub. You can also sign in with a GitHub personal access token that has Contents: read and write access to screen-gd/portfolio.site. On the local server from npm run dev, use the token or, in Chrome or Edge, "Work with Local Repository" to edit this folder directly, then commit and push yourself.

GitHub sign-in is handled by the site's Worker (worker/index.ts) and needs a one-time setup:

1. Create a GitHub OAuth app (GitHub → Settings → Developer settings → OAuth Apps → New OAuth App). Set Homepage URL to https://zaid.us.ci and Authorization callback URL to https://zaid.us.ci/oauth/callback.
2. Generate a client secret, then add both values to the site-portfolio Worker as secrets named GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET (Cloudflare dashboard → Workers → site-portfolio → Settings → Variables and Secrets, or npx wrangler secret put GITHUB_CLIENT_ID).

• New post creates a Markdown file in content/blog/.
• Images you upload (cover or inline) are saved in public/blog/.
• Publish commits to main. The site updates on the next build and deploy.

By hand

Add a Markdown file to content/blog/, such as my-first-post.md. The filename becomes its URL: /blog/my-first-post.

Only title is required. You can also put the title in a leading # Title heading instead. The first paragraph becomes the summary on the Blog page. Posts with dates appear newest first; the newest is featured, with its cover when supplied.

Use ## for section headings. A link to an X post, such as [Chike](https://x.com/user/status/123), shows a preview of the post on hover.

Put images in public/blog/ and reference them as /blog/image-name.png.