finereli/yarareads: A free studying app for youths who simply realized their phonics sounds: each phrase in a narrative will be sounded out, faucet a phrase for its sounds. Bring your personal agent (MCP). Cloudflare Workers. · GitHub

Read it: yarareads.finereli.com – free, no account wanted.

A studying app for youths who’ve simply realized their phonics sounds and want one thing actual to learn. Every phrase in a narrative will be
sounded out with the sounds they already know. When they get caught, they faucet the phrase and its sound buttons seem proper there.

I made it for my daughter Yara. She’s six and loves glitter, magic and dragons. She’d completed Teach Your Monster to Read and I
could not discover something for her to learn subsequent that was each an excellent story and made solely of phrases she may sound out. Her massive brother
Tom wrote the primary story, and the app is constructed so there will be many extra.

• The assist lives on the phrase. Tap any phrase: a dot underneath single letters, a bar underneath pairs like “sh” and “ee”, an arc becoming a member of
  cut up vowels like a_e. One speaker button lights every sound in flip, then says the phrase. It by no means reads entire pages for them.
• The checker is the purpose. Stories are checked phrase by phrase in opposition to the sounds the kid is aware of, by pronunciation and never
  simply spelling (“cake” fails if the kid hasn’t realized the cut up a). npm run test fails a narrative with a phrase they cannot learn.
• Bring your personal books. Connect your personal agent (Claude, ChatGPT, something that speaks MCP) and it writes tales inside your
  kid’s sounds, or sorts in books you personal. It checks its personal phrases, provides photos, and exhibits you the consequence. Only your account sees them.
• You set what your baby is aware of. Switch sounds and tough phrases on or off. Words with a sound they have not realized get a dotted
  underline and the brand new sound exhibits in purple.

It’s a Cloudflare Worker with static belongings, D1 for knowledge and R2 for photos. No construct step. If you are a tech dad (or mum) with a
child who’s studying to learn, I’d love you to take this and make it yours.

git clone https://github.com/finereli/yarareads && cd yarareads
npm set up
npx wrangler d1 create yara-reads          # put the database_id in wrangler.jsonc, along with your account_id
npx wrangler r2 bucket create yara-reads-pictures
npx wrangler d1 migrations apply yara-reads --local
node instruments/lexicon-asset.mjs               # the phrase dictionary the employee makes use of
node instruments/push.mjs --local --inventory --images --owner dev   # load the tales (--owner: books from residence, in case you have any)
npx wrangler dev

Then npm run deploy once you’re completely happy (edit the routes in wrangler.jsonc in your area; deploy wants the dictionary step,
which the script runs for you).

Things to know:

• It works signed out. That’s the entire app, with the sounds and progress saved within the browser. Accounts (and so brokers) use
  login.finereli.com, which solely serves my very own apps. To run accounts your self, swap in your personal sign-in: public/login.js and
  src/verify-login.js are the one information that learn about it.
• The sounds are my voice, recorded for the tiles, and so they aren’t on this repository. Without them the tiles nonetheless gentle up
  however keep quiet. Record your personal with instruments/sounds-record.mjs (see the remark on the high). Words are spoken by Cloudflare
  Workers AI, so deploying wants an account with that enabled.
• Write a narrative: copy content material/tales/toby-1.json, edit the pages, run npm run test. It tells you each phrase your baby cannot
  learn but. Never loosen the sounds to make a narrative cross: rewrite the story. docs/vocabulary.md has the queue of what to show subsequent.
• Pictures: docs/illustration.md and instruments/illustrate.mjs describe how the illustrations have been made.
• CLAUDE.md explains how every part matches collectively, for you or your agent.
• Usage numbers: node instruments/stats.mjs.

Code: MIT (LICENSE). Stories and photos: Creative Commons Attribution 4.0 (content material/LICENSE.md), so remix away and credit score
Yara Reads and the authors. Third-party materials: NOTICE.md.

Privacy · Terms