101 Field Guide
0. Orientation

How a web page becomes alive.

A web page starts as structure. Then it gets style. Then it gets behavior. Then it connects to other systems.

This is the simple mental model: HTML gives the page a body, CSS gives it visual character, JavaScript makes it respond, and APIs let it talk to places outside itself.

The living stack

Structure
HTML names the parts on the page.
Style
CSS decides how those parts look.
Action
JavaScript changes things when people interact.
Connection
API moves data between systems.

Frame it this way: web coding is less mysterious when you can point to what each layer is responsible for.

1. HTML

HTML is the page's frame.

HTML is not a full software framework like React or Next.js. It is more basic and more important: it is the markup that gives the page its parts.

Headings, paragraphs, links, buttons, forms, images, tables, and sections all begin as HTML. Without it, CSS has nothing to style and JavaScript has nothing reliable to control.

What HTML gives you

Skeleton
<section> groups one idea.
Meaning
<h1> says this is the main heading.
Action point
<button> marks something people can press.
<section>
  <h1>Shelter Dashboard</h1>
  <p>Open shelters and available capacity.</p>
  <button>Show open shelters</button>
</section>
  • HTML is read by browsers, screen readers, search engines, and code.
  • Good HTML makes the page easier to style, test, and improve later.
  • When HTML is clear, the rest of the system has a stable foundation.
2. CSS

CSS gives the structure a visual voice.

CSS controls color, spacing, type, layout, borders, states, and motion. It turns raw HTML into something that feels intentional.

The important idea is separation: HTML says what a thing is. CSS says how that thing should appear on different screens.

Same HTML, styled interface

Colorsignal and mood
Spacingreading rhythm
Layoutdesktop and mobile
Stateshover, focus, active

Plain version: CSS is not decoration after the real work. CSS is part of how the interface communicates.

3. JavaScript

JavaScript makes the page react.

JavaScript listens for events and changes the page. Clicks, searches, filters, maps, menus, calculators, form validation, and live updates all depend on behavior.

HTML can place a button on the page. CSS can make it look right. JavaScript decides what happens when someone presses it.

Action loop

User eventClick, type, scroll, submit, choose.
JavaScriptReads the event and decides what to change.
Updated pageNew state appears without rebuilding the whole page.
button.addEventListener("click", () => {
  panel.textContent = "Showing open shelters";
});
4. APIs

An API is how systems talk.

An API is a doorway with rules. One system asks for something in an agreed format, and another system responds in an agreed format.

An API is not automatically the backend. It is the connector. It can connect your frontend to your backend, your map to ArcGIS, or your dashboard to a weather service.

Interconnectivity

Web pageNeeds data or wants to save work.
APIThe request and response contract.
Other systemDatabase, ArcGIS, Vercel function, spreadsheet, or service.

Simple rule: if one piece of software needs to ask another piece of software for something, an API is probably involved.

5. Frontend

The frontend is what the person touches.

The frontend runs in the browser. It is the visible and interactive part: pages, buttons, menus, forms, maps, charts, tables, and visual feedback.

Frontend work blends structure, style, and behavior. A good frontend does not just look nice. It helps people understand where they are, what changed, and what to do next.

Browser-side work

Render
Show information Headings, maps, tables, charts, pages.
Respond
Handle interaction Clicks, filters, searches, menus.
Request
Ask for data Calls APIs when it needs outside information.

In a Red Cross-style map app: the frontend is the map screen, the filter controls, the popup, and the visible workflow.

6. Backend

The backend does work out of sight.

The backend usually runs on a server. It can check permissions, talk to databases, call secure services, process files, generate reports, or protect secrets.

The user may never see the backend directly. They see the frontend. But the frontend often depends on backend work to get trusted data and complete real tasks.

Server-side work

Protect
Keep secrets server-side API keys, credentials, protected logic.
Store
Read and write data Databases, files, records, logs.
Process
Do heavier work Geocoding, reports, exports, analysis.
7. Python

Python is a general-purpose workbench.

Python is a full programming language, not just a cleanup tool. It is good at telling the computer to do repeatable work: read files, transform data, call APIs, run GIS analysis, generate reports, and power server-side logic.

In this learning map, Python is the lane for automation, analysis, and backend work. HTML/CSS/JavaScript still own the browser experience, but Python often prepares the data, checks the logic, or runs the service behind it.

Python can be

A scriptA repeatable recipe that renames files, cleans a spreadsheet, or exports a report.
A notebookA place to mix code, explanation, tables, charts, and GIS checks while exploring a problem.
A data toolA way to join, filter, summarize, geocode, validate, or reshape messy operational data.
A GIS partnerA way to work with feature layers, shapefiles, maps, spatial joins, and ArcGIS automation.
An API clientA way to ask other systems for data, process the response, and send useful results elsewhere.
A backendA server-side language for routes, jobs, trusted logic, database work, and app services.

Plain version: use Python when the work needs calculation, automation, GIS processing, backend logic, or repeatable analysis. Use HTML/CSS/JS when the work needs to become the visible browser experience.

8. IDE + command line

Your coding workspace has two doors.

An IDE like Cursor is the visual workbench. It helps you read files, edit code, search a project, and use AI assistance without leaving the project.

The command line is the direct control panel. It runs scripts, starts local servers, installs packages, checks Git status, and talks to tools that do not have buttons.

Two ways into the same project

IDE

Best for reading, editing, comparing, searching, and staying oriented inside many files.

Command line

Best for running, checking, installing, deploying, and repeating exact steps.

Beginner rule: you do not need to love the command line. You need to recognize when it is the shortest path.

9. GitHub, Vercel, Supabase

Build, store, publish, and remember.

Git and GitHub track your project history. Vercel publishes the project to the web. Supabase gives an app a database, login system, storage, and backend-like services when a static page is no longer enough.

These are not the same thing, but they often sit next to each other in one real project.

Project path

GitHubStores code and history.
VercelBuilds or serves the web app.
SupabaseStores app data when the site needs memory.
  • Git is the version tracking tool on your machine.
  • GitHub is where the tracked project can live online.
  • Vercel is where the project can become a public URL.
  • Supabase is where an app can keep structured data.
10. AI assistants

Codex, Claude, Copilot, and Gemini are different kinds of help.

Think of AI coding tools as teammates with different seats. Some are inside the editor, some are local agent workspaces, some are chat-based explainers, and some connect to documents or browser context.

The important beginner move is not choosing one forever. It is learning what kind of help you need: explain, draft, edit, test, research, or operate across files.

Assistant map

CodexWorks in a local project, edits files, runs checks, and verifies results.
Claude CodeAnother agent-style coding partner for project work and long refactors.
CopilotSits close to the editor and helps write or complete code in place.
GeminiUseful for chat, multimodal context, and Google-connected workflows.

Simple frame: ask whether you need a tutor, an editor assistant, or an agent that can move through a project.

11. ArcGIS + SDK

ArcGIS is the GIS platform. The SDK is a code door into it.

ArcGIS Online, Experience Builder, Survey123, dashboards, feature layers, and web maps are platform tools. They help you make GIS products without starting from empty code.

The ArcGIS Maps SDK is what you use when you want custom web behavior around maps: specialized filters, custom workflows, app-specific controls, or map interactions that a no-code builder does not easily support.

GIS bridge

ArcGIS platformLayers, maps, surveys, dashboards, Experience Builder.
SDKCode that reads and controls maps in a custom web app.
Custom appA focused interface for the exact workflow.

Beginner rule: use Experience Builder when it already solves the workflow. Reach for the SDK when the map needs behavior the builder cannot express cleanly.

12. How it connects

The full loop is the real lesson.

Most useful web apps are not one technology. They are a chain of responsibilities. Each part is simpler when it does its own job.

One complete project

BrowserShows the result to the user.
HTMLDefines the parts and meaning.
CSSControls the visual system.
JavaScriptHandles interaction and state.
APIConnects the page to other systems.
PythonAutomates, analyzes, integrates, and can power backend work.
GitHub + VercelStore and publish the project.
ArcGIS + SupabaseProvide maps, layers, and app data.

The point: learn coding faster by asking which layer owns the problem you are looking at.

Glossary

Words that stop sounding mysterious.

Search a term, or scroll the list. The definitions stay plain on purpose. This is vocabulary for getting oriented, not documentation for experts.

Advanced shelf

The second pass can get more technical.

These ideas matter, but they should not interrupt the first beginner path. Keep them here until the foundation is comfortable.

Packages and dependencies

Reusable code your project installs instead of writing everything from scratch.

Environment variables and secrets

Private values like API keys that should not be pasted into public frontend code.

Authentication

How apps know who someone is and what they are allowed to access.

Databases and schemas

How structured data is organized so apps can query it reliably.

Testing and verification

How you prove a page or workflow still works after changes.