Final Project & Career
Published by Brayan K
You'll build a complete, persistent Todo app one milestone at a time — combining the DOM, events, array methods, and localStorage into a single app you can put in your portfolio.
Part of the free JavaScript course at LearnCodingFast — hands-on lessons with examples you run in your browser, plus practice exercises and a quick quiz.
Make the model authoritative before wiring the interface
The app needs one explicit model: version, next ID and a task array. The visible filtered list is derived from that model, so deleting a filtered row must use its stable ID rather than its current screen position. A storage string is an input to validate, not automatically trusted application state.
const tasks = [
{ id: 1, text: "Read", done: true },
{ id: 2, text: "Practise", done: false },
{ id: 3, text: "Review", done: false }
];
// The first visible active task is not the first task in the full model.
const visible = tasks.filter(task => !task.done);
const removeId = visible[0].id;
const remaining = tasks.filter(task => task.id !== removeId);
console.log(visible.map(task => task.id).join(", "));
console.log(remaining.map(task => task.id).join(", "));
// ✅ Expected output:
// 2, 3
// 1, 3Use native forms, checkboxes, labels and buttons so keyboard interaction has a real semantic foundation. Events owns event propagation and form handling; Advanced Array & Object Transformations owns immutable selection and updates.
Validate the whole saved envelope before using any task
function decodeTodo(text) {
const value = JSON.parse(text);
if (!value || typeof value !== "object" || value.version !== 1 ||
!Array.isArray(value.tasks) || value.tasks.length > 100 ||
!Number.isInteger(value.nextId) || value.nextId < 1 || value.nextId > 100001) {
throw new TypeError("invalid saved list");
}
const ids = new Set();
const tasks = value.tasks.map(task => {
if (!task || typeof task !== "object" || !Number.isInteger(task.id) ||
task.id < 1 || task.id >= value.nextId || ids.has(task.id) ||
typeof task.text !== "string" || task.text.trim().length < 1 ||
task.text.trim().length > 80 || typeof task.done !== "boolean") {
throw new TypeError("invalid saved task");
}
ids.add(task.id);
return { id: task.id, text: task.text.trim(), done: task.done };
});
return { version: 1, nextId: value.nextId, tasks };
}
const raw = JSON.stringify({ version: 1, nextId: 3, tasks: [
{ id: 1, text: " Read ", done: false, privateNote: "not selected" }
] });
console.log(JSON.stringify(decodeTodo(raw)));
try { decodeTodo(JSON.stringify({ version: 1, nextId: 2, tasks: [
{ id: 1, text: "A", done: false }, { id: 1, text: "B", done: true }
] })); } catch (error) { console.log(error.name, error.message); }
// ✅ Expected output:
// {"version":1,"nextId":3,"tasks":[{"id":1,"text":"Read","done":false}]}
// TypeError invalid saved taskReject duplicate IDs, missing required fields and unsupported versions. The next ID must exceed every saved task ID. Selecting fresh fields also avoids importing unrelated data into the app. Deep Dive into JSON, Parsing & Serialization owns representation boundaries; Web Storage APIs (localStorage, sessionStorage, IndexedDB) owns storage failures and transaction alternatives.
function decodeTodo(text) {
const value = JSON.parse(text);
if (!value || typeof value !== "object" || value.version !== 1 ||
!Array.isArray(value.tasks) || value.tasks.length > 100 ||
!Number.isInteger(value.nextId) || value.nextId < 1 || value.nextId > 100001) {
throw new TypeError("invalid saved list");
}
const ids = new Set();
const tasks = value.tasks.map(task => {
if (!task || typeof task !== "object" || !Number.isInteger(task.id) ||
task.id < 1 || task.id >= value.nextId || ids.has(task.id) ||
typeof task.text !== "string" || task.text.trim().length < 1 ||
task.text.trim().length > 80 || typeof task.done !== "boolean") {
throw new TypeError("invalid saved task");
}
ids.add(task.id);
return { id: task.id, text: task.text.trim(), done: task.done };
});
return { version: 1, nextId: value.nextId, tasks };
}
decodeTodo('{"version":2,"nextId":1,"tasks":[]}');
// ✅ Expected error:
// TypeError: invalid saved listDo not silently overwrite unreadable saved data with an empty model during startup. The complete app keeps it intact, allows in-memory work and exposes an explicit replacement action. A failed write leaves the current in-memory list available and labels it unsaved.
Render user text as text and preserve a useful focus target
const label = document.createElement("span");
label.textContent = '<img src=x onerror="alert(1)">';
document.getElementById("app").append(label);
console.log(label.children.length, label.textContent.includes("<img"));
// ✅ Expected output:
// 0 trueThe final app constructs elements and text nodes; it does not concatenate task labels into HTML. Checkbox changes redraw the derived list, then restore focus to the task’s replacement control or the input if that task leaves the current filter. Deleting a row chooses a neighbouring visible task before falling back to the input.
Focus behavior is part of the interaction contract, not a cosmetic detail. Client-Side Security Essentials (XSS, CSRF, Sanitisation) owns safe sinks; Building Reusable UI Components with Pure JS owns component lifetime and cleanup.
Guided exercise: toggle one stable task ID
Fill the literal hints. Return a new array and a new record for the changed task while preserving the untouched record.
const tasks = [{ id: 1, text: "Read", done: false }, { id: 2, text: "Write", done: false }];
const targetId = 2;
const changed = tasks.___(task => task.id === targetId ? { ...task, done: ___ } : task); // 👉 replace ___ with map
// 👉 replace ___ with true
console.log(changed[1].done, tasks[1].done);
console.log(changed[0] === tasks[___]); // 👉 replace ___ with 0
// ✅ Expected output:
// true false
// trueBuild brief: a complete persistent task list with visible failure states
Implement decodeTodo and mountTodo(root, storage, key). Use an empty HTMLElement and a getItem/setItem storage adapter. The schema has version 1, nextId in 1–100001 and at most 100 tasks. Every task has a unique integer ID at least one and below nextId, trimmed text of 1–80 UTF-16 code units, and a boolean done flag. Select only these fields.
Provide add, toggle, delete and all/active/completed filtering, an active count, visible storage status and an explicit save/replacement button. Accept at most 100 tasks and stop assigning IDs after 100000. Keep unreadable saved data untouched until the user explicitly replaces it. Save ordinary changes when storage was read successfully, while retaining the in-memory model if a write fails.
Use text nodes for labels, stable IDs for actions, native controls and deliberate focus after redraw. Return a detached snapshot and an idempotent disposer that removes owned nodes and exact listeners. This version is a single-tab model; it does not merge simultaneous edits across tabs or provide remote backup.
function decodeTodo(text) {
const value = JSON.parse(text);
if (!value || typeof value !== "object" || value.version !== 1 ||
!Array.isArray(value.tasks) || value.tasks.length > 100 ||
!Number.isInteger(value.nextId) || value.nextId < 1 || value.nextId > 100001) {
throw new TypeError("invalid saved list");
}
const ids = new Set();
const tasks = value.tasks.map(task => {
if (!task || typeof task !== "object" || !Number.isInteger(task.id) ||
task.id < 1 || task.id >= value.nextId || ids.has(task.id) ||
typeof task.text !== "string" || task.text.trim().length < 1 ||
task.text.trim().length > 80 || typeof task.done !== "boolean") {
throw new TypeError("invalid saved task");
}
ids.add(task.id);
return { id: task.id, text: task.text.trim(), done: task.done };
});
return { version: 1, nextId: value.nextId, tasks };
}
function mountTodo(root, storage, key = "lcs-todo-app-v1") {
if (!(root instanceof HTMLElement) || root.childNodes.length ||
!storage || typeof storage.getItem !== "function" || typeof storage.setItem !== "function" ||
typeof key !== "string" || !key.length) throw new TypeError("empty root and storage adapter required");
let model = { version: 1, nextId: 1, tasks: [] }, canSave = true, active = true, filter = "all";
let initialStatus = "No saved tasks";
try {
const raw = storage.getItem(key);
if (raw !== null) { model = decodeTodo(raw); initialStatus = "Saved list loaded"; }
} catch {
canSave = false;
initialStatus = "Saved data could not be read. Changes stay here until you explicitly replace the saved list.";
}
const form = document.createElement("form"), label = document.createElement("label");
label.append("New task ");
const input = document.createElement("input"); input.type = "text"; input.maxLength = 80;
label.append(input);
const add = document.createElement("button"); add.type = "submit"; add.textContent = "Add task";
form.append(label, add);
const filterLabel = document.createElement("label"); filterLabel.append("Show ");
const select = document.createElement("select");
for (const value of ["all", "active", "completed"]) {
const option = document.createElement("option"); option.value = value; option.textContent = value; select.append(option);
}
filterLabel.append(select);
const list = document.createElement("ul"), count = document.createElement("p"), status = document.createElement("p");
status.setAttribute("role", "status"); status.textContent = initialStatus;
const save = document.createElement("button"); save.type = "button";
save.textContent = canSave ? "Save current list" : "Replace unreadable saved list";
root.append(form, filterLabel, count, list, save, status);
function visible() { return model.tasks.filter(task => filter === "all" || (filter === "completed") === task.done); }
function render(focusId = null) {
list.replaceChildren();
for (const task of visible()) {
const item = document.createElement("li"), label = document.createElement("label"), checkbox = document.createElement("input");
checkbox.type = "checkbox"; checkbox.checked = task.done; checkbox.dataset.id = String(task.id);
label.append(checkbox, document.createTextNode(" " + task.text));
const remove = document.createElement("button"); remove.type = "button"; remove.dataset.remove = String(task.id);
remove.textContent = "Delete"; remove.setAttribute("aria-label", "Delete " + task.text);
item.append(label, remove); list.append(item);
}
count.textContent = model.tasks.filter(task => !task.done).length + " active of " + model.tasks.length;
if (focusId !== null) {
const control = [...list.querySelectorAll("input[data-id]")].find(node => Number(node.dataset.id) === focusId);
(control || input).focus();
}
}
function persist(explicit = false) {
if (!canSave && !explicit) {
status.textContent = "Changes are in memory. Unreadable saved data has not been overwritten.";
return false;
}
try {
storage.setItem(key, JSON.stringify(model)); canSave = true;
save.textContent = "Save current list"; status.textContent = "Saved";
return true;
} catch { status.textContent = "Not saved. Your current list is still available in this tab."; return false; }
}
function onSubmit(event) {
event.preventDefault();
if (!active) return;
const text = input.value.trim();
if (!text || text.length > 80) { status.textContent = "Enter a task from 1 to 80 characters."; input.focus(); return; }
if (model.tasks.length >= 100 || model.nextId > 100000) { status.textContent = "This list has reached its limit."; return; }
model = { ...model, nextId: model.nextId + 1, tasks: [...model.tasks, { id: model.nextId, text, done: false }] };
input.value = ""; render(); persist(); input.focus();
}
function onChange(event) {
const checkbox = event.target;
if (!active || !(checkbox instanceof HTMLInputElement) || !checkbox.matches("input[data-id]")) return;
const id = Number(checkbox.dataset.id);
if (!model.tasks.some(task => task.id === id)) return;
model = { ...model, tasks: model.tasks.map(task => task.id === id ? { ...task, done: checkbox.checked } : task) };
render(id); persist();
}
function onDelete(event) {
const button = event.target instanceof Element ? event.target.closest("button[data-remove]") : null;
if (!active || !button || !list.contains(button)) return;
const id = Number(button.dataset.remove), before = visible(), index = before.findIndex(task => task.id === id);
if (index < 0) return;
const focusId = before[index + 1]?.id ?? before[index - 1]?.id ?? null;
model = { ...model, tasks: model.tasks.filter(task => task.id !== id) };
render(focusId); if (focusId === null) input.focus(); persist();
}
function onFilter() { if (active) { filter = select.value; render(); } }
function onSave() { if (active) persist(true); }
form.addEventListener("submit", onSubmit); list.addEventListener("change", onChange); list.addEventListener("click", onDelete);
select.addEventListener("change", onFilter); save.addEventListener("click", onSave);
render();
return Object.freeze({
snapshot() { return decodeTodo(JSON.stringify(model)); },
dispose() {
if (!active) return; active = false;
form.removeEventListener("submit", onSubmit); list.removeEventListener("change", onChange); list.removeEventListener("click", onDelete);
select.removeEventListener("change", onFilter); save.removeEventListener("click", onSave);
form.remove(); filterLabel.remove(); count.remove(); list.remove(); save.remove(); status.remove();
}
});
}
const values = new Map();
const storage = { getItem: key => values.get(key) ?? null, setItem: (key, value) => values.set(key, value) };
const root = document.createElement("section");
document.getElementById("app").append(root);
const ui = mountTodo(root, storage);
const input = root.querySelector('input[type="text"]');
input.value = " Read ";
root.querySelector("form").requestSubmit();
root.querySelector('input[type="checkbox"]').click();
console.log(JSON.stringify(ui.snapshot()));
console.log(root.querySelector('[role="status"]').textContent);
ui.dispose();
const restored = mountTodo(root, storage);
console.log(restored.snapshot().tasks[0].done, root.querySelectorAll("li").length);
restored.dispose(); root.remove();
// ✅ Expected output:
// {"version":1,"nextId":2,"tasks":[{"id":1,"text":"Read","done":true}]}
// Saved
// true 1Run the same app against real localStorage and remount it
function decodeTodo(text) {
const value = JSON.parse(text);
if (!value || typeof value !== "object" || value.version !== 1 ||
!Array.isArray(value.tasks) || value.tasks.length > 100 ||
!Number.isInteger(value.nextId) || value.nextId < 1 || value.nextId > 100001) {
throw new TypeError("invalid saved list");
}
const ids = new Set();
const tasks = value.tasks.map(task => {
if (!task || typeof task !== "object" || !Number.isInteger(task.id) ||
task.id < 1 || task.id >= value.nextId || ids.has(task.id) ||
typeof task.text !== "string" || task.text.trim().length < 1 ||
task.text.trim().length > 80 || typeof task.done !== "boolean") {
throw new TypeError("invalid saved task");
}
ids.add(task.id);
return { id: task.id, text: task.text.trim(), done: task.done };
});
return { version: 1, nextId: value.nextId, tasks };
}
function mountTodo(root, storage, key = "lcs-todo-app-v1") {
if (!(root instanceof HTMLElement) || root.childNodes.length ||
!storage || typeof storage.getItem !== "function" || typeof storage.setItem !== "function" ||
typeof key !== "string" || !key.length) throw new TypeError("empty root and storage adapter required");
let model = { version: 1, nextId: 1, tasks: [] }, canSave = true, active = true, filter = "all";
let initialStatus = "No saved tasks";
try {
const raw = storage.getItem(key);
if (raw !== null) { model = decodeTodo(raw); initialStatus = "Saved list loaded"; }
} catch {
canSave = false;
initialStatus = "Saved data could not be read. Changes stay here until you explicitly replace the saved list.";
}
const form = document.createElement("form"), label = document.createElement("label");
label.append("New task ");
const input = document.createElement("input"); input.type = "text"; input.maxLength = 80;
label.append(input);
const add = document.createElement("button"); add.type = "submit"; add.textContent = "Add task";
form.append(label, add);
const filterLabel = document.createElement("label"); filterLabel.append("Show ");
const select = document.createElement("select");
for (const value of ["all", "active", "completed"]) {
const option = document.createElement("option"); option.value = value; option.textContent = value; select.append(option);
}
filterLabel.append(select);
const list = document.createElement("ul"), count = document.createElement("p"), status = document.createElement("p");
status.setAttribute("role", "status"); status.textContent = initialStatus;
const save = document.createElement("button"); save.type = "button";
save.textContent = canSave ? "Save current list" : "Replace unreadable saved list";
root.append(form, filterLabel, count, list, save, status);
function visible() { return model.tasks.filter(task => filter === "all" || (filter === "completed") === task.done); }
function render(focusId = null) {
list.replaceChildren();
for (const task of visible()) {
const item = document.createElement("li"), label = document.createElement("label"), checkbox = document.createElement("input");
checkbox.type = "checkbox"; checkbox.checked = task.done; checkbox.dataset.id = String(task.id);
label.append(checkbox, document.createTextNode(" " + task.text));
const remove = document.createElement("button"); remove.type = "button"; remove.dataset.remove = String(task.id);
remove.textContent = "Delete"; remove.setAttribute("aria-label", "Delete " + task.text);
item.append(label, remove); list.append(item);
}
count.textContent = model.tasks.filter(task => !task.done).length + " active of " + model.tasks.length;
if (focusId !== null) {
const control = [...list.querySelectorAll("input[data-id]")].find(node => Number(node.dataset.id) === focusId);
(control || input).focus();
}
}
function persist(explicit = false) {
if (!canSave && !explicit) {
status.textContent = "Changes are in memory. Unreadable saved data has not been overwritten.";
return false;
}
try {
storage.setItem(key, JSON.stringify(model)); canSave = true;
save.textContent = "Save current list"; status.textContent = "Saved";
return true;
} catch { status.textContent = "Not saved. Your current list is still available in this tab."; return false; }
}
function onSubmit(event) {
event.preventDefault();
if (!active) return;
const text = input.value.trim();
if (!text || text.length > 80) { status.textContent = "Enter a task from 1 to 80 characters."; input.focus(); return; }
if (model.tasks.length >= 100 || model.nextId > 100000) { status.textContent = "This list has reached its limit."; return; }
model = { ...model, nextId: model.nextId + 1, tasks: [...model.tasks, { id: model.nextId, text, done: false }] };
input.value = ""; render(); persist(); input.focus();
}
function onChange(event) {
const checkbox = event.target;
if (!active || !(checkbox instanceof HTMLInputElement) || !checkbox.matches("input[data-id]")) return;
const id = Number(checkbox.dataset.id);
if (!model.tasks.some(task => task.id === id)) return;
model = { ...model, tasks: model.tasks.map(task => task.id === id ? { ...task, done: checkbox.checked } : task) };
render(id); persist();
}
function onDelete(event) {
const button = event.target instanceof Element ? event.target.closest("button[data-remove]") : null;
if (!active || !button || !list.contains(button)) return;
const id = Number(button.dataset.remove), before = visible(), index = before.findIndex(task => task.id === id);
if (index < 0) return;
const focusId = before[index + 1]?.id ?? before[index - 1]?.id ?? null;
model = { ...model, tasks: model.tasks.filter(task => task.id !== id) };
render(focusId); if (focusId === null) input.focus(); persist();
}
function onFilter() { if (active) { filter = select.value; render(); } }
function onSave() { if (active) persist(true); }
form.addEventListener("submit", onSubmit); list.addEventListener("change", onChange); list.addEventListener("click", onDelete);
select.addEventListener("change", onFilter); save.addEventListener("click", onSave);
render();
return Object.freeze({
snapshot() { return decodeTodo(JSON.stringify(model)); },
dispose() {
if (!active) return; active = false;
form.removeEventListener("submit", onSubmit); list.removeEventListener("change", onChange); list.removeEventListener("click", onDelete);
select.removeEventListener("change", onFilter); save.removeEventListener("click", onSave);
form.remove(); filterLabel.remove(); count.remove(); list.remove(); save.remove(); status.remove();
}
});
}
const key = "lcs-todo-lesson-fixture";
const previous = localStorage.getItem(key);
localStorage.setItem(key, JSON.stringify({ version: 1, nextId: 1, tasks: [] }));
const storage = { getItem: key => localStorage.getItem(key), setItem: (key, value) => localStorage.setItem(key, value) };
const root = document.createElement("section"); document.body.append(root);
let ui;
try {
ui = mountTodo(root, storage, key);
root.querySelector('input[type="text"]').value = "Persisted task";
root.querySelector("form").requestSubmit();
ui.dispose();
ui = mountTodo(root, storage, key);
console.log(ui.snapshot().tasks[0].text);
console.log(root.querySelector('[role="status"]').textContent);
} finally {
ui?.dispose(); root.remove();
if (previous === null) localStorage.removeItem(key); else localStorage.setItem(key, previous);
}Output
Persisted task
Saved list loadedRun in your own browser project on localhost or HTTPS, in a module script or DevTools. This example needs real browser storage; the site editor isolates it.
The browser-project panel uses real localStorage and restores its temporary fixture key afterward. The ordinary site-editor demo uses an explicitly labelled Map-backed adapter because the editor isolates browser storage. Neither result proves cross-tab synchronization, permanent retention or a hosted backend.
Before extending the app, test duplicate saved IDs, invalid saved versions, blocked reads, failed writes, empty input, maximum length, filtered deletion, checkbox focus, repeated mount/dispose and a task label containing HTML-like text. Add editing, ordering or synchronization only after specifying their data and conflict rules.
Practice quiz
What does this complete program print? const tasks=[{id:1,done:true},{id:2,done:false}];console.log(tasks.filter(x=>!x.done)[0].id);
- 2
- 1
- 0
- undefined
Answer: 2. A visible position is not a stable model identity.
What should startup do with saved data that fails validation?
- Immediately replace it with an empty list
- Keep it intact and show an explicit recovery choice
- Treat every task as valid anyway
- Hide the error and claim success
Answer: Keep it intact and show an explicit recovery choice. Avoid silently destroying unreadable data while still explaining the state to the user.
What does this complete program print? const label=document.createElement("span");label.textContent="<b>task</b>";console.log(label.children.length);
- 1
- 2
- 0
- undefined
Answer: 0. textContent creates text rather than parsing markup.
A storage write throws after a new task was added. What should this app show?
- Saved
- The task was never entered
- A permanent backup guarantee
- The current list with an explicit unsaved status
Answer: The current list with an explicit unsaved status. The in-memory edit and persistence outcome are separate facts.
What does this complete program print? const before=[{id:1,done:false}];const after=before.map(x=>({...x,done:true}));console.log(before[0].done,after[0].done);
- false true
- true true
- false false
- true false
Answer: false true. The update creates a new task record instead of mutating the old one.
Why restore focus after replacing list nodes?
- To change the task IDs
- The old focused control may no longer exist
- To make localStorage asynchronous
- To avoid validating saved data
Answer: The old focused control may no longer exist. Replacing a focused node can leave keyboard users without a useful focus location.
What does this complete program print? const saved={version:1,nextId:2,tasks:[{id:1,text:"Read",done:false}]};console.log(saved.nextId>saved.tasks[0].id);
- false
- undefined
- true
- TypeError
Answer: true. The next ID stays above every persisted task ID.
Which feature is outside this capstone’s stated contract?
- Adding and deleting tasks
- Visible write failures
- Real localStorage remounting
- Merging concurrent edits from multiple tabs
Answer: Merging concurrent edits from multiple tabs. Cross-tab conflict resolution needs a separate policy and implementation.
Continue this course
- Previous: Checkpoint: Browser APIs
- Next: Web Components & Custom Elements — Build reusable, framework-agnostic elements with Custom Elements and Shadow DOM
- Quick reference: JavaScript cheat sheet