Skip to content

About

A static international activity library for grown-ups and children ages 3–6.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

3-6 Pal

3-6 Pal is a static, international-first activity library for grown-ups and children ages 3-6. It helps a caregiver choose a five-minute, low-prep activity using ordinary materials and a clear prompt.

The validation release intentionally has no accounts, payments, advertising, child profiles, or behavioral tracking. Bookmarks are stored only in the visitor's browser with localStorage.

Stack

  • Next.js 16 App Router with TypeScript and React 19
  • Static export (output: "export") with unoptimized local images
  • Tailwind CSS 4 and project CSS in src/app/globals.css
  • Lucide icons
  • Cloudflare Workers Static Assets via Wrangler

Local development

The project uses pnpm. With Node.js 20+ available:

pnpm install
pnpm dev

Open http://localhost:3000. To use the bundled workspace runtime on the development machine, prepend these directories to PATH:

$env:Path='C:\Users\Administrator\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin;C:\Users\Administrator\.cache\codex-runtimes\codex-primary-runtime\dependencies\bin\fallback;'+$env:Path

Content editing

All public activity content lives in src/data/activities.ts. Each activity has a stable slug, age range, duration, category, materials, skills, steps, grown-up tip, and optional safety note.

When adding an activity:

  1. Add a complete record to activities.ts with a unique URL-safe slug.
  2. Keep the activity safe for ages 3-6, low-prep, and usable without an account.
  3. Add or reuse a category icon in src/components/category-icon.tsx if a new category is introduced.
  4. Run the checks below. The sitemap and static detail route are generated from the data automatically.

Verification

pnpm lint
pnpm typecheck
pnpm build
pnpm deploy:dry

pnpm build creates the static site in out/. The current release generates the home page, activity library, private-in-browser Saved page, 30 activity detail pages, About, Privacy, a custom 404 page, robots.txt, and sitemap.xml.

For a local Cloudflare runtime preview after building:

pnpm preview

Cloudflare deployment

The production path is Cloudflare Workers Builds connected to this GitHub repository. Every push to the selected production branch runs the static export and then publishes out/ through the Worker configuration in wrangler.jsonc. This is a Worker with Static Assets, not a Pages project; it needs no server-side runtime, database, or application secret.

GitHub + Cloudflare Workers Builds setup

  1. Push this repository to GitHub (the repository can be private or public).
  2. In Cloudflare, open Workers & Pages > Create application > Workers > Connect to Git and select the GitHub repository. In an existing Worker, use Settings > Builds > Connect repository.
  3. Select the production branch (normally main) and use these build settings:
    • Build command: pnpm build
    • Deploy command: pnpm deploy
    • Non-production branch deploy command: pnpm exec wrangler versions upload
    • Root directory: / (the repository root)
    • Build watch paths: src/**, public/**, next.config.ts, package.json, pnpm-lock.yaml, wrangler.jsonc
    • Node.js version: 20 or newer
    • Package manager: pnpm
  4. Workers Builds runs the build command first. pnpm build creates out/; the deploy command runs Wrangler, which reads the assets.directory value from wrangler.jsonc and uploads the static assets to the Worker.
  5. In Settings > Builds, select Connect and authorize the Cloudflare Workers & Pages GitHub App for tonylate520/three-six-pal. Workers automatically creates a build token for the connected account. Do not commit an API token or put one in the repository.
  6. In the Worker, open Settings > Domains & Routes and attach 36pal.com and, if needed, www.36pal.com. Keep https://36pal.com as the preferred canonical host; redirect www to the apex host with a Worker route or Cloudflare redirect rule.
  7. Verify HTTPS, the home page, /activities/, one activity detail URL, /saved/, /robots.txt, /sitemap.xml, and a missing URL after the first successful build.

After the first connection, the Worker's Deployments tab should show a Build history entry for the GitHub commit. A deployment listed as Source: Upload is the manual Wrangler path and does not prove that GitHub Builds is connected yet.

The repository also includes the same deploy scripts for a manual Workers deployment when GitHub Builds are not being used:

pnpm build
pnpm deploy:dry
pnpm deploy

Ongoing releases

Push content or UI changes to the connected production branch. Cloudflare Workers Builds will install dependencies, run pnpm build, and publish the resulting out/ directory through wrangler deploy. Before pushing, run:

pnpm lint && pnpm typecheck && pnpm build && pnpm deploy:dry

No environment variables are required by the validation release. Do not add analytics, ad scripts, or child-identifying data without revisiting the privacy and product review.

Project structure

src/app/                  Routes, metadata, sitemap, and global styles
src/components/           Finder, library, cards, shared header/footer, actions
src/data/                 Structured activity content and matching helpers
public/images/             Local editorial image assets
wrangler.jsonc             Cloudflare Workers Static Assets configuration

Release notes

  • The domain-facing brand is written as 3-6 Pal in source and metadata so it remains clear in terminals and deployment tooling; the UI may use the typographic range mark where supported.
  • The app is intentionally static. Adding personalization, accounts, or a CMS would change the hosting and privacy model and should be treated as a separate phase.

About

A static international activity library for grown-ups and children ages 3–6.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages