whatisgithub

What is english-lock-widget?

vbondarenko7/english-lock-widget — explained in plain English

Analysis updated 2026-05-18

15SwiftAudience · generalComplexity · 2/5LicenseSetup · moderate

In one sentence

An iOS Lock Screen widget that shows a new English word with a picture each time you unlock your phone, for passive vocabulary learning without translation.

Mindmap

mindmap
  root((English Lock Widget))
    What it does
      Shows word on lock screen
      No translation shown
      Passive vocabulary exposure
    Tech stack
      Swift
      WidgetKit
      SF Symbols
      xcodegen
    Use cases
      Learn English passively
      Build a personal lock screen widget
      Study via Comprehensible Input
    Audience
      Language learners
      Non developer hobbyists
    Design constraints
      Monochrome tint only
      No progress tracking
      206 hand picked words

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a personal Lock Screen widget that passively teaches new English words on every unlock

USE CASE 2

Learn how to structure a WidgetKit accessory widget with a static local word list

USE CASE 3

Adapt the same word-and-icon approach to build a widget for learning a different language

USE CASE 4

See a real example of a non-developer building a working iOS app with an AI coding assistant

What is it built with?

SwiftWidgetKitSF Symbolsxcodegen

How does it compare?

vbondarenko7/english-lock-widgetemanuele-web04/remodextextkitcounter-ltd/clonk
Stars151516
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyhard
Complexity2/53/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Xcode, xcodegen, and a personal Apple ID for signing since it is sideloaded rather than distributed via the App Store.

Free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

So what is it?

English Lock Widget is a personal iOS Lock Screen widget built to help someone passively pick up English vocabulary just by unlocking their phone. Every time you unlock your iPhone, the Lock Screen shows a new English word paired with a small icon and a short phrase giving it context, with no translation into another language shown alongside it. The idea behind this comes from a language learning theory called Comprehensible Input, associated with the linguist Stephen Krashen, which holds that people absorb a language most naturally through repeated, meaningful exposure rather than through direct translation and memorization drills. Since most people unlock their phone somewhere between eighty and one hundred fifty times a day, each unlock becomes a small, repeated moment of exposure that adds up over time. Technically, the widget is built using Apple's WidgetKit for an .accessoryRectangular Lock Screen widget, available on iOS 17 and newer. It reads a static words.json file bundled with the app, and each time the system refreshes the widget, it shows one of twelve randomly chosen entries. There is no shared app group and no persistent state tracking which words you have already seen. The icons use Apple's own SF Symbols library rather than full color images, since Lock Screen widgets render everything in a single tint color and photographic images would not display correctly there. The word list itself contains 206 hand-picked words at an intermediate, B1 to B2 level, each checked so its icon maps to the word in a clear, literal way rather than through a stretched metaphor. The project deliberately leaves out spaced repetition, progress tracking, and any kind of scoring, since the goal is passive exposure rather than active study. Notably, the README states this was built in one evening by someone with no prior iOS or Swift development experience, using Claude Code, with the design and planning process included in the repository's documentation folder. Building it requires Xcode and the xcodegen tool, and it is meant to be installed on your own device with a personal Apple ID rather than distributed through the App Store. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Show me how to install xcodegen and build this project so I can run it on my own iPhone
Prompt 2
Help me add my own words to the words.json file with matching SF Symbols
Prompt 3
Explain how the accessoryRectangular WidgetKit widget type works for Lock Screen widgets
Prompt 4
Walk me through adapting this widget's design for a language other than English
Prompt 5
How does the Comprehensible Input approach in this app's word choices work

Frequently asked questions

What is english-lock-widget?

An iOS Lock Screen widget that shows a new English word with a picture each time you unlock your phone, for passive vocabulary learning without translation.

What language is english-lock-widget written in?

Mainly Swift. The stack also includes Swift, WidgetKit, SF Symbols.

What license does english-lock-widget use?

Free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

How hard is english-lock-widget to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is english-lock-widget for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.