gitwtfhub

wtf is smurfling-lessons?

weblate/smurfling-lessons — explained in plain English

Analysis updated 2026-08-07 · repo last pushed 2026-07-23

Audience · generalComplexity · 1/5ActiveLicenseSetup · easy

TL;DR

A beginner-friendly mobile website that teaches new players how to play Ingress, a location-based augmented reality game, through 36 bite-sized lessons with progress saved in the browser.

Mindmap

mindmap
  root((repo))
    What it does
      Teaches Ingress basics
      36 bite-sized lessons
      Searchable glossary
      Saves progress locally
    Features
      Medal case display
      Readiness score tracker
      Six ops categories
      No accounts needed
    Privacy
      No analytics or cookies
      Static pre-built site
      Browser storage only
    Audience
      New Ingress players
      Community team leads
    Localization
      Australian English
      US English
    Licensing
      Open source code
      Creative Commons content

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

Why would anyone build with this?

REASON 1

Point a newly recruited Ingress player to this guide so they can learn game basics at their own pace.

REASON 2

Look up confusing Ingress jargon using the searchable glossary with in-lesson definitions.

REASON 3

Track learning progress through 36 lessons with a readiness score saved in the browser.

REASON 4

Help new players find and connect with their local Ingress community via the resources page.

What's in the stack?

JavaScriptHTMLCSS

How it stacks up

weblate/smurfling-lessons000madz000/rfid-attendance00kaku/gallery-slider-block
LanguageTypeScriptJavaScript
Last pushed2026-07-232024-07-222021-05-19
MaintenanceActiveDormantDormant
Setup difficultyeasyeasyeasy
Complexity1/52/52/5
Audiencegeneraldevelopergeneral

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

No setup needed, it's a static website, just open it in a mobile browser.

The code is open source and the written lessons are shared under a Creative Commons license, allowing the community to freely use and adapt the educational content.

Wtf does this do

Smurfling Guide is a beginner-friendly mobile website that teaches new players how to play Ingress, a location-based augmented reality game. Think of it as an interactive orientation manual that walks a freshly recruited player through everything they need to know to start playing alongside their local team. It replaces an older version of the guide with updated content that reflects current game mechanics. The site is organized like an agent profile dashboard, featuring a hex-shaped medal case and a readiness score. It offers six categories called "ops," each containing six bite-sized lessons, for a total of 36 lessons. As players read through the material, their progress is saved directly in their phone's browser. There are no accounts to create and no analytics or cookies tracking their activity. It also includes a searchable glossary so players can look up confusing terms, with definitions popping up directly within the lessons themselves. This project is built for Ingress community leaders and the new players they recruit, often called "smurflings." When someone joins the game, they are typically overwhelmed by the complex mechanics and jargon. A local team lead can point a new recruit to this guide, knowing they will learn the ropes at their own pace. The resources page specifically helps these new players find and connect with their local community. The guide even caters to regional spelling differences, offering both Australian and US English versions with automatic browser detection on the first visit. A notable tradeoff of this project is its strict focus on simplicity and privacy. The entire site is pre-built and static, meaning it loads incredibly fast on mobile phones and requires almost no JavaScript to run. By storing progress in the browser rather than on a server, the creators avoid the overhead and privacy concerns of user accounts entirely. The code is open source, while the written lessons themselves are shared under a creative commons license, allowing the community to freely use and adapt the educational content.

Yoink these prompts

Prompt 1
I'm a new Ingress player trying to understand the game. Walk me through the six ops categories and what kind of lessons I'll find in each one, as if I'm browsing the Smurfling Guide.
Prompt 2
I want to build a similar beginner-friendly guide site for another game. Based on the Smurfling Guide approach, how should I structure bite-sized lessons, save progress in the browser without accounts, and include a searchable glossary?
Prompt 3
Help me adapt the Smurfling Guide's Creative Commons lesson content for my local Ingress community. What are the 36 lessons and how can I present them in a way that helps new recruits connect with our team?
Prompt 4
I'm an Ingress community leader. Give me a plan for onboarding a new player using a 36-lesson guide with a medal case and readiness score. How should I pace the lessons and when should I introduce them to the local community?

Frequently asked questions

wtf is smurfling-lessons?

A beginner-friendly mobile website that teaches new players how to play Ingress, a location-based augmented reality game, through 36 bite-sized lessons with progress saved in the browser.

Is smurfling-lessons actively maintained?

Active — commit in last 30 days (last push 2026-07-23).

What license does smurfling-lessons use?

The code is open source and the written lessons are shared under a Creative Commons license, allowing the community to freely use and adapt the educational content.

How hard is smurfling-lessons to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is smurfling-lessons for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.