<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Thiago Carvalho</title>
    <description>The latest articles on DEV Community by Thiago Carvalho (@thiagooak).</description>
    <link>https://dev.to/thiagooak</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F754689%2F2c656c78-ae9a-457c-a319-e3d73f27cf64.jpeg</url>
      <title>DEV Community: Thiago Carvalho</title>
      <link>https://dev.to/thiagooak</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/thiagooak"/>
    <language>en</language>
    <item>
      <title>Build a temperature converter web page in Clojure (no experience needed)</title>
      <dc:creator>Thiago Carvalho</dc:creator>
      <pubDate>Tue, 03 Nov 2026 14:03:00 +0000</pubDate>
      <link>https://dev.to/thiagooak/build-a-temperature-converter-web-page-in-clojure-no-experience-needed-22mh</link>
      <guid>https://dev.to/thiagooak/build-a-temperature-converter-web-page-in-clojure-no-experience-needed-22mh</guid>
      <description>&lt;p&gt;This is part four of a series teaching Clojure to people with little or no programming experience.&lt;/p&gt;

&lt;p&gt;In Part 3, you built a few static pages that look the same for every visitor.&lt;/p&gt;

&lt;p&gt;Now we'll build a small dynamic page, one that changes depending on what the visitor asks for. It converts temperatures in Celsius to Fahrenheit. You'll also meet the REPL, the "smarter way of working" mentioned in Part 1.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 1: Pull values out of the URL
&lt;/h2&gt;

&lt;p&gt;First, bring in Clojure's string functions. Update the &lt;code&gt;ns&lt;/code&gt; at the top of &lt;code&gt;src/app/core.clj&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;ns&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;app.core&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;org.httpkit.server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
            &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;clojure.string&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:gen-class&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Now we can use &lt;code&gt;str/split&lt;/code&gt;, &lt;code&gt;str/blank?&lt;/code&gt;, and friends.&lt;/p&gt;

&lt;p&gt;Then add these two functions above &lt;code&gt;handler&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;url-decode&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;java.net.URLDecoder/decode&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"UTF-8"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;parse-query&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;query-string&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;when-not&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;str/blank?&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;query-string&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;into&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{}&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;for&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;pair&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;str/split&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;query-string&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;#&lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
                &lt;/span&gt;&lt;span class="no"&gt;:let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;v&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;str/split&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;pair&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;#&lt;/span&gt;&lt;span class="s"&gt;"="&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)]]&lt;/span&gt;&lt;span class="w"&gt;
            &lt;/span&gt;&lt;span class="p"&gt;[(&lt;/span&gt;&lt;span class="nf"&gt;url-decode&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;url-decode&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;or&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;v&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;""&lt;/span&gt;&lt;span class="p"&gt;))]))))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Save the file. Let's take it apart:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;URLs can't contain spaces or most symbols, so browsers &lt;em&gt;encode&lt;/em&gt; them. A space becomes &lt;code&gt;+&lt;/code&gt; and &lt;code&gt;&amp;lt;&lt;/code&gt; becomes &lt;code&gt;%3C&lt;/code&gt;. &lt;code&gt;url-decode&lt;/code&gt; puts them back to their original form.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;parse-query&lt;/code&gt; splits the text on &lt;code&gt;&amp;amp;&lt;/code&gt; to get one chunk per parameter (&lt;code&gt;a=1&amp;amp;b=2&lt;/code&gt; becomes &lt;code&gt;a=1&lt;/code&gt; and &lt;code&gt;b=2&lt;/code&gt;). &lt;code&gt;#"&amp;amp;"&lt;/code&gt; is a &lt;em&gt;pattern&lt;/em&gt;: it means "wherever you find an &lt;code&gt;&amp;amp;&lt;/code&gt;".&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;for&lt;/code&gt; goes through the chunks one at a time and builds a new collection from them. Think of it as "for each chunk, do this".&lt;/li&gt;
&lt;li&gt;For each chunk it splits on the first &lt;code&gt;=&lt;/code&gt; to get a key and a value. &lt;code&gt;[k v]&lt;/code&gt; is a shortcut that takes the two pieces apart and names them &lt;code&gt;k&lt;/code&gt; and &lt;code&gt;v&lt;/code&gt;. If the chunk has no &lt;code&gt;=&lt;/code&gt; at all (as in &lt;code&gt;?celsius&lt;/code&gt;), there is no &lt;code&gt;v&lt;/code&gt;, so &lt;code&gt;(or v "")&lt;/code&gt; uses empty text instead.&lt;/li&gt;
&lt;li&gt;It decodes both, and &lt;code&gt;into {}&lt;/code&gt; collects the key/value pairs into a map.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;when-not&lt;/code&gt; runs its body only if the condition is false. If the query string is blank, there is nothing to parse, so &lt;code&gt;parse-query&lt;/code&gt; returns &lt;code&gt;nil&lt;/code&gt;, which means "nothing here". That's fine: looking something up in &lt;code&gt;nil&lt;/code&gt; just gives you &lt;code&gt;nil&lt;/code&gt; back.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Try it in the REPL
&lt;/h3&gt;

&lt;p&gt;How do you know &lt;code&gt;parse-query&lt;/code&gt; works? You could wire it into &lt;code&gt;handler&lt;/code&gt;, restart the server and visit a URL. Or you can just &lt;em&gt;call it&lt;/em&gt;.&lt;/p&gt;

&lt;p&gt;Open a new terminal (&lt;strong&gt;Terminal&lt;/strong&gt; &amp;gt; &lt;strong&gt;New Terminal&lt;/strong&gt;) and run:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;clojure
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You'll get a prompt that looks like &lt;code&gt;user=&amp;gt;&lt;/code&gt;.&lt;br&gt;
This is a REPL (Read, Evaluate, Print, Loop): you type a Clojure expression, it runs it and shows you the result.&lt;br&gt;
Type or paste each expression below into the REPL and press Enter. The &lt;code&gt;;;&lt;/code&gt; lines show what you should see back, so you don't need to type them.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="ss"&gt;'app.core&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; nil&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/parse-query&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius=20&amp;amp;unit=c"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; {"celsius" "20", "unit" "c"}&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/parse-query&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; nil&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;require&lt;/code&gt; loads your file. The &lt;code&gt;'&lt;/code&gt; in front of &lt;code&gt;app.core&lt;/code&gt; tells Clojure "don't try to look it up right now". To call one of your functions, put its namespace in front: &lt;code&gt;app.core/parse-query&lt;/code&gt; is the &lt;code&gt;parse-query&lt;/code&gt; from &lt;code&gt;src/app/core.clj&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;No server, no browser and no restart. REPL-driven development lets you iterate and explore your code with instant feedback. In this series we'll use the REPL directly by typing text in a terminal window, but if you installed &lt;a href="https://calva.io" rel="noopener noreferrer"&gt;Calva&lt;/a&gt; in Part 1, it can also run code straight from your editor.&lt;/p&gt;

&lt;p&gt;Leave the REPL open: we'll come back to it in the next step. Later, when you're done with it, close it by pressing &lt;code&gt;Ctrl+D&lt;/code&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: Convert Celsius to Fahrenheit
&lt;/h2&gt;

&lt;p&gt;The formula to convert from Celsius to Fahrenheit is &lt;code&gt;F = C × 9/5 + 32&lt;/code&gt;.&lt;br&gt;
Add it above &lt;code&gt;handler&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;+&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;*&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;9&lt;/span&gt;&lt;span class="n"&gt;/5&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;32&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;(* c 9/5)&lt;/code&gt; means "&lt;code&gt;c&lt;/code&gt; times 9/5", and &lt;code&gt;(+ ... 32)&lt;/code&gt; adds 32 to that. In Clojure the operation comes first, just like any other function: &lt;code&gt;(+ 1 2)&lt;/code&gt; is 1 plus 2.&lt;/p&gt;

&lt;p&gt;Save the file and go back to the REPL. It doesn't notice that the file changed, so ask it to load the file again (note the &lt;code&gt;:reload&lt;/code&gt;), then try a few temperatures:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="ss"&gt;'app.core&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:reload&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; nil&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mf"&gt;20.0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; 68.0&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mf"&gt;100.0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; 212.0&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mf"&gt;-40.0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; -40.0&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;It works! -40 is the point where the temperature is the same in both scales.&lt;/p&gt;

&lt;h3&gt;
  
  
  Wire it to the URL
&lt;/h3&gt;

&lt;p&gt;On the website, the number won't come from you typing &lt;code&gt;20.0&lt;/code&gt;. It will come from the URL, through &lt;code&gt;parse-query&lt;/code&gt;.&lt;br&gt;
Let's try that. &lt;code&gt;get&lt;/code&gt; looks up a key in a map, so this pulls the value of &lt;code&gt;"celsius"&lt;/code&gt; out of what &lt;code&gt;parse-query&lt;/code&gt; returned:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;get&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/parse-query&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius=20"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; "20"&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Now give that value to &lt;code&gt;celsius-&amp;gt;fahrenheit&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;get&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/parse-query&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius=20"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; Execution error (ClassCastException) at app.core/celsius-&amp;gt;fahrenheit (core.clj:...).&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; class java.lang.String cannot be cast to class java.lang.Number ...&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The error tells you what happened (&lt;code&gt;String cannot be cast to Number&lt;/code&gt;) and where (&lt;code&gt;celsius-&amp;gt;fahrenheit&lt;/code&gt;).&lt;/p&gt;

&lt;p&gt;Look closely at the result of the &lt;code&gt;get&lt;/code&gt; above: it's &lt;code&gt;"20"&lt;/code&gt;, with quotes. That's text, not the number &lt;code&gt;20&lt;/code&gt;.&lt;br&gt;
&lt;code&gt;celsius-&amp;gt;fahrenheit&lt;/code&gt; expects a number, and &lt;code&gt;parse-query&lt;/code&gt; returns text even when it looks like a number. We need to convert it.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;parse-double&lt;/code&gt; converts text to a number. It comes with Clojure, so it doesn't need the &lt;code&gt;app.core/&lt;/code&gt; prefix:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;parse-double&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"20"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; 20.0&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Now it should work:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;parse-double&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"20"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; 68.0&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Step 3: Run the server from the REPL
&lt;/h2&gt;

&lt;p&gt;So far you've run the server in its own terminal with &lt;code&gt;clojure -M:run&lt;/code&gt;, and restarting it meant &lt;code&gt;Ctrl+C&lt;/code&gt; and typing the command again.&lt;br&gt;
You already have a REPL open, so let's run the server from there instead and do everything in one place.&lt;/p&gt;

&lt;p&gt;If the server from Part 3 is still running in another terminal, stop it with &lt;code&gt;Ctrl+C&lt;/code&gt;. Two programs can't both use port 8080 at the same time.&lt;/p&gt;

&lt;p&gt;At the bottom of &lt;code&gt;src/app/core.clj&lt;/code&gt;, replace &lt;code&gt;-main&lt;/code&gt; with:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;defonce&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;atom&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;nil&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;stop-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;when-let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;stop&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;@&lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;stop&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;reset!&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;nil&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;start-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;stop-server&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;Integer/parseInt&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;or&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;System/getenv&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"PORT"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"8080"&lt;/span&gt;&lt;span class="p"&gt;))]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;reset!&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;http/run-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="p"&gt;}))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;println&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Server running on port "&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;-main&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="o"&gt;&amp;amp;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;_args&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;start-server&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;There is a lot of code here, so let's go slowly:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;atom&lt;/code&gt; is a box that holds a value that can change. Ours starts out holding &lt;code&gt;nil&lt;/code&gt; (nothing), and it will hold the running server.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;defonce&lt;/code&gt; is like &lt;code&gt;def&lt;/code&gt;, but it only happens once. A &lt;code&gt;:reload&lt;/code&gt; runs every line of the file again, and without &lt;code&gt;defonce&lt;/code&gt; the box would be replaced by an empty one, and we'd lose track of a server that is still running.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;@server&lt;/code&gt; looks inside the box, and &lt;code&gt;reset!&lt;/code&gt; puts a new value in it. The &lt;code&gt;!&lt;/code&gt; at the end of a name is a convention that warns "this may change something".&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;http/run-server&lt;/code&gt; starts the server and gives back a &lt;em&gt;function that stops it&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;stop-server&lt;/code&gt; uses &lt;code&gt;when-let&lt;/code&gt;: if the box holds something, name it &lt;code&gt;stop&lt;/code&gt;, call it, and empty the box. If the box is empty, there's nothing to stop, so it does nothing.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;start-server&lt;/code&gt; always calls &lt;code&gt;stop-server&lt;/code&gt; first. That's what makes it safe to run as many times as you like: every call is a restart.&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;let&lt;/code&gt; with &lt;code&gt;port&lt;/code&gt; is the same code that used to be in &lt;code&gt;-main&lt;/code&gt;, moved into &lt;code&gt;start-server&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;-main&lt;/code&gt; now just calls &lt;code&gt;start-server&lt;/code&gt;, so &lt;code&gt;clojure -M:run&lt;/code&gt; and Vercel still work exactly as before.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Save the file. Then, in the REPL, load the new code and start the server:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="ss"&gt;'app.core&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:reload&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; nil&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/start-server&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="c1"&gt;;; Server running on port 8080&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Open &lt;a href="http://localhost:8080" rel="noopener noreferrer"&gt;http://localhost:8080&lt;/a&gt;: it's your website, running from the REPL.&lt;/p&gt;

&lt;p&gt;From now on, this is the rhythm: &lt;strong&gt;edit, save, reload, restart&lt;/strong&gt;. Reloading is the &lt;code&gt;require&lt;/code&gt; with &lt;code&gt;:reload&lt;/code&gt;, and restarting is &lt;code&gt;(app.core/start-server)&lt;/code&gt;. You can run both in one go by pasting them on the same line:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="ss"&gt;'app.core&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:reload&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/start-server&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;To stop the server, run &lt;code&gt;(app.core/stop-server)&lt;/code&gt;. Closing the REPL with &lt;code&gt;Ctrl+D&lt;/code&gt; stops it too.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 4: Build the page
&lt;/h2&gt;

&lt;p&gt;Let's put this conversion to work in a page. Add this function above &lt;code&gt;handler&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;convert-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;parse-double&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;get&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius"&lt;/span&gt;&lt;span class="p"&gt;))]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Celsius to Fahrenheit"&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;Celsius to Fahrenheit&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;deg;C is "&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;deg;F&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;let&lt;/code&gt; gives a name to a value: &lt;code&gt;c&lt;/code&gt; is the number &lt;code&gt;parse-double&lt;/code&gt; got from the text.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;(get params "celsius")&lt;/code&gt; is the same lookup you just tried in the REPL. In Part 3, &lt;code&gt;(:uri req)&lt;/code&gt; worked because &lt;code&gt;:uri&lt;/code&gt; is a keyword. The keys in &lt;code&gt;params&lt;/code&gt; are &lt;em&gt;text&lt;/em&gt; (&lt;code&gt;"celsius"&lt;/code&gt;), and text can't look itself up, so we use &lt;code&gt;get&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;&amp;amp;deg;&lt;/code&gt; is HTML's way of writing the degree sign.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;And add a route to &lt;code&gt;handler&lt;/code&gt;, before the 404 at the end:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;case&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:uri&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/"&lt;/span&gt;&lt;span class="w"&gt;        &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;home-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/about"&lt;/span&gt;&lt;span class="w"&gt;   &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;about-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/convert"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;convert-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;parse-query&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:query-string&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;404&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;not-found-page&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Save the file, then reload and restart in the REPL:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="ss"&gt;'app.core&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:reload&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;app.core/start-server&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then visit &lt;a href="http://localhost:8080/convert?celsius=20" rel="noopener noreferrer"&gt;http://localhost:8080/convert?celsius=20&lt;/a&gt;.&lt;br&gt;
You should see &lt;code&gt;20.0°C is 68.0°F&lt;/code&gt;. Try &lt;code&gt;celsius=100&lt;/code&gt; and &lt;code&gt;celsius=-40&lt;/code&gt; too.&lt;/p&gt;

&lt;p&gt;Now try two addresses a visitor could easily go to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Visit &lt;code&gt;/convert&lt;/code&gt; with nothing after it.&lt;/li&gt;
&lt;li&gt;Visit &lt;code&gt;/convert?celsius=banana&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Both of these produce an error page, with messages like &lt;code&gt;Expected string, got nil&lt;/code&gt; and &lt;code&gt;Cannot invoke "Object.getClass()" because "x" is null&lt;/code&gt;. The REPL will show you the full error message.&lt;/p&gt;
&lt;h2&gt;
  
  
  Step 5: Fail gracefully
&lt;/h2&gt;

&lt;p&gt;There are two different problems here:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;No value at all.&lt;/strong&gt; &lt;code&gt;/convert&lt;/code&gt; has no &lt;code&gt;celsius&lt;/code&gt;, so &lt;code&gt;get&lt;/code&gt; returns &lt;code&gt;nil&lt;/code&gt;, and &lt;code&gt;parse-double&lt;/code&gt; refuses it: that's the &lt;code&gt;Expected string, got nil&lt;/code&gt; error.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A value that isn't a number.&lt;/strong&gt; &lt;code&gt;parse-double&lt;/code&gt; doesn't crash on &lt;code&gt;"banana"&lt;/code&gt;. It returns &lt;code&gt;nil&lt;/code&gt;, its way of saying "this isn't a number". The crash comes one step later, when &lt;code&gt;celsius-&amp;gt;fahrenheit&lt;/code&gt; tries to do math with &lt;code&gt;nil&lt;/code&gt;: that's the &lt;code&gt;Object.getClass()&lt;/code&gt; error.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;In both cases there's nothing to convert, so the page should simply show no result. Replace &lt;code&gt;convert-page&lt;/code&gt; with:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;convert-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;celsius-str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;get&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Celsius to Fahrenheit"&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;Celsius to Fahrenheit&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;when-let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;parse-double&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;celsius-str&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt;&lt;span class="w"&gt;
                 &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;deg;C is "&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;deg;F&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))))))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;(get params "celsius" "")&lt;/code&gt; has a third part: a default. If there's no &lt;code&gt;"celsius"&lt;/code&gt; in the map, &lt;code&gt;get&lt;/code&gt; returns &lt;code&gt;""&lt;/code&gt; (empty text) instead of &lt;code&gt;nil&lt;/code&gt;. &lt;code&gt;parse-double&lt;/code&gt; is happy with empty text: it isn't a number, so it returns &lt;code&gt;nil&lt;/code&gt;. That turns the first problem into the second one.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;when-let&lt;/code&gt;, which you saw in &lt;code&gt;stop-server&lt;/code&gt;, handles the second problem. It runs &lt;code&gt;(parse-double celsius-str)&lt;/code&gt;, and if the result is a number, it names it &lt;code&gt;c&lt;/code&gt; and builds the result paragraph. If the result is &lt;code&gt;nil&lt;/code&gt;, it skips its body and returns &lt;code&gt;nil&lt;/code&gt;, and &lt;code&gt;str&lt;/code&gt; treats &lt;code&gt;nil&lt;/code&gt; as empty text, so the page shows no result at all.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Notice how &lt;code&gt;nil&lt;/code&gt; did the work here. We didn't stop it from showing up, we only did the math when there was something.&lt;/p&gt;

&lt;p&gt;Save the file, then reload and restart in the REPL (&lt;code&gt;(require 'app.core :reload) (app.core/start-server)&lt;/code&gt;) and try the two broken URLs again. Now both give you the page, without a result.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 6: Add a form
&lt;/h2&gt;

&lt;p&gt;Nobody wants to edit URLs by hand. Let's add a form so visitors can type a value and press a button.&lt;br&gt;
Replace &lt;code&gt;convert-page&lt;/code&gt; with:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;convert-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;celsius-str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;get&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Celsius to Fahrenheit"&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;Celsius to Fahrenheit&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;form method=\"get\" action=\"/convert\"&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;input type=\"text\" name=\"celsius\" placeholder=\"Enter Celsius\"&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;button type=\"submit\"&amp;gt;Convert&amp;lt;/button&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/form&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;when-let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;parse-double&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;celsius-str&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt;&lt;span class="w"&gt;
                 &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;deg;C is "&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;deg;F&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))))))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;&amp;lt;form&amp;gt;&lt;/code&gt; sends the visitor to &lt;code&gt;/convert?celsius=whatever-they-typed&lt;/code&gt;, which is the same address you've been typing by hand.&lt;br&gt;
The box comes back empty after they press the button, but the result line shows the number they converted.&lt;/p&gt;

&lt;p&gt;Save the file, then reload and restart in the REPL (&lt;code&gt;(require 'app.core :reload) (app.core/start-server)&lt;/code&gt;) and use the form.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Checkpoint:&lt;/strong&gt; you've now got an interactive page, one that responds differently depending on what a visitor types.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;
  
  
  The whole file
&lt;/h2&gt;

&lt;p&gt;Here is the full &lt;code&gt;src/app/core.clj&lt;/code&gt; at this point. If something isn't working, compare yours to this one:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;ns&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;app.core&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;org.httpkit.server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
            &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;clojure.string&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:gen-class&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;!DOCTYPE html&amp;gt;&amp;lt;html&amp;gt;&amp;lt;head&amp;gt;&amp;lt;title&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/title&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;style&amp;gt;body{font-family:sans-serif;max-width:600px;margin:40px auto;padding:0 20px}"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"nav a{margin-right:12px}&amp;lt;/style&amp;gt;&amp;lt;/head&amp;gt;&amp;lt;body&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;nav&amp;gt;&amp;lt;a href=\"/\"&amp;gt;Home&amp;lt;/a&amp;gt;&amp;lt;a href=\"/about\"&amp;gt;About&amp;lt;/a&amp;gt;&amp;lt;/nav&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/body&amp;gt;&amp;lt;/html&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;home-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Home"&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;Hi, I'm Carvalho&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;Welcome to my corner of the internet.&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;ul&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;li&amp;gt;&amp;lt;a href=\"https://github.com\"&amp;gt;GitHub&amp;lt;/a&amp;gt;&amp;lt;/li&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/ul&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;about-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"About"&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;About Me&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;I'm learning Clojure and building my first website!&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;not-found-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Not Found"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;404 - Page Not Found&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;url-decode&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;java.net.URLDecoder/decode&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;s&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"UTF-8"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;parse-query&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;query-string&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;when-not&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;str/blank?&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;query-string&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;into&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{}&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;for&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;pair&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;str/split&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;query-string&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;#&lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
                &lt;/span&gt;&lt;span class="no"&gt;:let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;v&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;str/split&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;pair&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;#&lt;/span&gt;&lt;span class="s"&gt;"="&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)]]&lt;/span&gt;&lt;span class="w"&gt;
            &lt;/span&gt;&lt;span class="p"&gt;[(&lt;/span&gt;&lt;span class="nf"&gt;url-decode&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;url-decode&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;or&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;v&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;""&lt;/span&gt;&lt;span class="p"&gt;))]))))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;+&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;*&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;9&lt;/span&gt;&lt;span class="n"&gt;/5&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;32&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;convert-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;celsius-str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;get&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"celsius"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Celsius to Fahrenheit"&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;Celsius to Fahrenheit&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;form method=\"get\" action=\"/convert\"&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;input type=\"text\" name=\"celsius\" placeholder=\"Enter Celsius\"&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;button type=\"submit\"&amp;gt;Convert&amp;lt;/button&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/form&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
               &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;when-let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;parse-double&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;celsius-str&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt;&lt;span class="w"&gt;
                 &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;deg;C is "&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;celsius-&amp;gt;fahrenheit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;amp;deg;F&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))))))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/html"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;case&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:uri&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/"&lt;/span&gt;&lt;span class="w"&gt;        &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;home-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/about"&lt;/span&gt;&lt;span class="w"&gt;   &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;about-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/convert"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;convert-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;parse-query&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:query-string&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;404&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;not-found-page&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;defonce&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;atom&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;nil&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;stop-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;when-let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;stop&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;@&lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;stop&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;reset!&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;nil&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;start-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;stop-server&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;Integer/parseInt&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;or&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;System/getenv&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"PORT"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"8080"&lt;/span&gt;&lt;span class="p"&gt;))]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;reset!&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;http/run-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="p"&gt;}))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;println&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Server running on port "&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;-main&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="o"&gt;&amp;amp;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;_args&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;start-server&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Deploy it
&lt;/h2&gt;

&lt;p&gt;Same command as before:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;vercel deploy &lt;span class="nt"&gt;--prod&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Open &lt;code&gt;/convert&lt;/code&gt; on your live link and try the form. Then throw some bad input at it: no value at all, and &lt;code&gt;banana&lt;/code&gt;.&lt;br&gt;
Both should give you a normal page.&lt;/p&gt;

&lt;h2&gt;
  
  
  If something went wrong
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Could not locate app/core&lt;/code&gt;&lt;/strong&gt; in the REPL: you started &lt;code&gt;clojure&lt;/code&gt; outside your &lt;code&gt;my-site&lt;/code&gt; folder. Press &lt;code&gt;Ctrl+D&lt;/code&gt;, close that terminal, and open a new one with &lt;strong&gt;Terminal&lt;/strong&gt; &amp;gt; &lt;strong&gt;New Terminal&lt;/strong&gt;. VS Code starts it inside &lt;code&gt;my-site&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The browser shows old content&lt;/strong&gt;: the REPL keeps its own copy of the code. Save the file, then reload and restart (&lt;code&gt;(require 'app.core :reload) (app.core/start-server)&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Address already in use&lt;/code&gt;&lt;/strong&gt; when you run &lt;code&gt;(app.core/start-server)&lt;/code&gt;: another program is using port 8080, most likely a &lt;code&gt;clojure -M:run&lt;/code&gt; still running in another terminal. Stop it with &lt;code&gt;Ctrl+C&lt;/code&gt; and try again.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Syntax error (ClassNotFoundException)&lt;/code&gt; mentioning &lt;code&gt;app.core&lt;/code&gt;&lt;/strong&gt;: this REPL hasn't loaded your file yet. Run &lt;code&gt;(require 'app.core)&lt;/code&gt; first. A new REPL always needs it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;No such var: app.core/start-server&lt;/code&gt;&lt;/strong&gt;: the REPL hasn't loaded your latest code. Save the file and run the &lt;code&gt;require&lt;/code&gt; with &lt;code&gt;:reload&lt;/code&gt; again.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Unable to resolve symbol: url-decode&lt;/code&gt;&lt;/strong&gt; (or &lt;code&gt;parse-query&lt;/code&gt;, &lt;code&gt;celsius-&amp;gt;fahrenheit&lt;/code&gt;...): the function is defined &lt;em&gt;below&lt;/em&gt; the code that uses it. Move it above.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;No such namespace: str&lt;/code&gt;&lt;/strong&gt;: the &lt;code&gt;[clojure.string :as str]&lt;/code&gt; line is missing from the &lt;code&gt;ns&lt;/code&gt; at the top of the file.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Expected string, got nil&lt;/code&gt; on the page&lt;/strong&gt;: &lt;code&gt;parse-double&lt;/code&gt; got &lt;code&gt;nil&lt;/code&gt;. Check that &lt;code&gt;convert-page&lt;/code&gt; uses &lt;code&gt;(get params "celsius" "")&lt;/code&gt;, with the &lt;code&gt;""&lt;/code&gt; default.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Cannot invoke "Object.getClass()"&lt;/code&gt; on the page&lt;/strong&gt;: &lt;code&gt;convert-page&lt;/code&gt; is doing math on &lt;code&gt;nil&lt;/code&gt;. Check that the result paragraph is inside the &lt;code&gt;when-let&lt;/code&gt; from Step 5.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What you learned
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Everything that comes from a URL is text. &lt;code&gt;parse-query&lt;/code&gt; turns &lt;code&gt;celsius=20&lt;/code&gt; into a map, and &lt;code&gt;parse-double&lt;/code&gt; turns the text &lt;code&gt;"20"&lt;/code&gt; into a number.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;when-let&lt;/code&gt; runs some code only when a value is there.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;get&lt;/code&gt; can take a default, like &lt;code&gt;(get params "celsius" "")&lt;/code&gt;, for when the key isn't in the map.&lt;/li&gt;
&lt;li&gt;The REPL lets you test your functions without having to wire them to the rest of the app and restart the server.&lt;/li&gt;
&lt;li&gt;An &lt;code&gt;atom&lt;/code&gt; holds a value that changes, like the running server. &lt;code&gt;start-server&lt;/code&gt; stops any old server before starting a new one, so restarting from the REPL is one line you can run again and again.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Next
&lt;/h2&gt;

&lt;p&gt;So far, every page is a function you wrote.&lt;br&gt;
In the next part we'll build pages out of &lt;em&gt;data&lt;/em&gt;: a blog that lists whatever files happen to be in a folder.&lt;/p&gt;

</description>
      <category>beginners</category>
      <category>clojure</category>
    </item>
    <item>
      <title>Build a multi-page website in Clojure: pages, links and a 404 page</title>
      <dc:creator>Thiago Carvalho</dc:creator>
      <pubDate>Mon, 26 Oct 2026 03:01:46 +0000</pubDate>
      <link>https://dev.to/thiagooak/learning-clojure-from-scratch-part-3-make-it-yours-2f28</link>
      <guid>https://dev.to/thiagooak/learning-clojure-from-scratch-part-3-make-it-yours-2f28</guid>
      <description>&lt;p&gt;This is part three of a series teaching Clojure to people with little or no programming experience.&lt;br&gt;
In Part 1 you ran a web server on your computer.&lt;br&gt;
In Part 2 you put it on the internet.&lt;/p&gt;

&lt;p&gt;In this part you'll go from a website that says &lt;code&gt;Hello, World!&lt;/code&gt; to a website with a home page, an about page, and a polite message for URLs that don't exist.&lt;/p&gt;
&lt;h2&gt;
  
  
  Step 1: Look at what the server receives
&lt;/h2&gt;

&lt;p&gt;Before we start building the new pages, let's look at the information available to &lt;code&gt;handler&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Temporarily change &lt;code&gt;handler&lt;/code&gt; in &lt;code&gt;src/app/core.clj&lt;/code&gt; so it sends the request back to you as text:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/plain"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;pr-str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)})&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Two changes: &lt;code&gt;_req&lt;/code&gt; is now &lt;code&gt;req&lt;/code&gt; because &lt;code&gt;handler&lt;/code&gt; is using it, and the body is now &lt;code&gt;(pr-str req)&lt;/code&gt;, which means "print this value as text".&lt;/p&gt;

&lt;p&gt;Remember the rhythm from Part 1: &lt;strong&gt;edit, stop, start, refresh&lt;/strong&gt;.&lt;br&gt;
Stop the server if it's still running (&lt;code&gt;Ctrl+C&lt;/code&gt;), start it again with &lt;code&gt;clojure -M:run&lt;/code&gt;, and open &lt;a href="http://localhost:8080/hello?name=carvalho" rel="noopener noreferrer"&gt;http://localhost:8080/hello?name=carvalho&lt;/a&gt;.&lt;br&gt;
You'll see something like this (shortened here):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:remote-addr&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"0:0:0:0:0:0:0:1"&lt;/span&gt;&lt;span class="n"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"accept"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/html,..."&lt;/span&gt;&lt;span class="n"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"host"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"localhost:8080"&lt;/span&gt;&lt;span class="n"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"user-agent"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Mozilla/5.0 ..."&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="n"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:server-port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;8080&lt;/span&gt;&lt;span class="n"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:uri&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"/hello"&lt;/span&gt;&lt;span class="n"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:query-string&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"name=carvalho"&lt;/span&gt;&lt;span class="n"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:request-method&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:get,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="n"&gt;...&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;That's the request. It's a map, just like the response.&lt;br&gt;
Two of its keys matter for this series:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;:uri&lt;/code&gt; is the part of the address after the host name: &lt;code&gt;/hello&lt;/code&gt;. We'll use it in this part to choose which page to show.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;:query-string&lt;/code&gt; is whatever comes after the &lt;code&gt;?&lt;/code&gt;: &lt;code&gt;name=carvalho&lt;/code&gt;. We'll use it in the next part.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Change the address to &lt;code&gt;/about&lt;/code&gt; or &lt;code&gt;/anything-you-like&lt;/code&gt; and watch &lt;code&gt;:uri&lt;/code&gt; change.&lt;br&gt;
Now that you know what a request contains, let's build the new pages.&lt;/p&gt;
&lt;h2&gt;
  
  
  Step 2: Send back HTML instead of plain text
&lt;/h2&gt;

&lt;p&gt;Put &lt;code&gt;handler&lt;/code&gt; back to saying hello (and &lt;code&gt;req&lt;/code&gt; back to &lt;code&gt;_req&lt;/code&gt;, since we're not looking at the request for now), but make it send HTML text.&lt;br&gt;
Change &lt;code&gt;Content-Type&lt;/code&gt; from &lt;code&gt;text/plain&lt;/code&gt; to &lt;code&gt;text/html&lt;/code&gt; and write HTML in the body:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;_req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/html"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;Hello, World!&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;Content-Type&lt;/code&gt; tells the browser how to read what it receives.&lt;br&gt;
&lt;code&gt;text/plain&lt;/code&gt; means "show it as text", &lt;code&gt;text/html&lt;/code&gt; means "this is an HTML page, interpret the tags".&lt;br&gt;
&lt;code&gt;&amp;lt;h1&amp;gt;...&amp;lt;/h1&amp;gt;&lt;/code&gt; is the HTML tag for a big heading.&lt;/p&gt;

&lt;p&gt;Restart, refresh, and the greeting becomes a heading.&lt;/p&gt;

&lt;p&gt;If you're new to HTML, a few tags will get you far:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;&amp;lt;h1&amp;gt;Title&amp;lt;/h1&amp;gt;&lt;/code&gt; for a heading.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;&amp;lt;p&amp;gt;Some text&amp;lt;/p&amp;gt;&lt;/code&gt; for a paragraph.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;&amp;lt;a href="https://example.com"&amp;gt;a link&amp;lt;/a&amp;gt;&lt;/code&gt; for a link.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;&amp;lt;ul&amp;gt;&lt;/code&gt; and &lt;code&gt;&amp;lt;li&amp;gt;&lt;/code&gt; for a bulleted list: the &lt;code&gt;&amp;lt;ul&amp;gt;&lt;/code&gt; is the list, and each &lt;code&gt;&amp;lt;li&amp;gt;&lt;/code&gt; is one item in it.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;&amp;lt;nav&amp;gt;&lt;/code&gt; for a group of navigation links. You'll see it in the next step.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;
  
  
  Step 3: Create a reusable page template
&lt;/h2&gt;

&lt;p&gt;Every page of a website needs the same frame: a title, some styling, a navigation bar, and so on.&lt;br&gt;
Typing that for each page would get old quickly.&lt;br&gt;
So let's write a function that takes the title and the content of a page and wraps them in a frame.&lt;/p&gt;

&lt;p&gt;Add this above &lt;code&gt;handler&lt;/code&gt; (Clojure reads a file from top to bottom, so a function has to be defined before the code that uses it):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;!DOCTYPE html&amp;gt;&amp;lt;html&amp;gt;&amp;lt;head&amp;gt;&amp;lt;title&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/title&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;style&amp;gt;body{font-family:sans-serif;max-width:600px;margin:40px auto;padding:0 20px}"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"nav a{margin-right:12px}&amp;lt;/style&amp;gt;&amp;lt;/head&amp;gt;&amp;lt;body&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;nav&amp;gt;&amp;lt;a href=\"/\"&amp;gt;Home&amp;lt;/a&amp;gt;&amp;lt;a href=\"/about\"&amp;gt;About&amp;lt;/a&amp;gt;&amp;lt;/nav&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/body&amp;gt;&amp;lt;/html&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;page&lt;/code&gt; receives two things, &lt;code&gt;title&lt;/code&gt; and &lt;code&gt;body&lt;/code&gt;, the same way &lt;code&gt;handler&lt;/code&gt; receives &lt;code&gt;req&lt;/code&gt;.&lt;br&gt;
Most of the text inside it is the frame itself. The &lt;code&gt;&amp;lt;style&amp;gt;&lt;/code&gt; and &lt;code&gt;&amp;lt;nav&amp;gt;&lt;/code&gt; lines are decoration, so you don't need to understand them yet. Just type them in.&lt;/p&gt;

&lt;p&gt;Two things to notice:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;str&lt;/code&gt; joins things together into one piece of text. &lt;code&gt;title&lt;/code&gt; and &lt;code&gt;body&lt;/code&gt; get dropped between the other pieces.&lt;/li&gt;
&lt;li&gt;To put a double quote &lt;em&gt;inside&lt;/em&gt; a piece of text you write &lt;code&gt;\"&lt;/code&gt;, which is why &lt;code&gt;href=\"/\"&lt;/code&gt; looks so busy. The backslash means "literally print this next character, I'm not trying to end the text."&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Now use &lt;code&gt;page&lt;/code&gt; to write two pages. Each one is a function with no inputs (that's the empty &lt;code&gt;[]&lt;/code&gt;), that returns HTML text:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;home-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Home"&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;Hi, I'm Carvalho&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;Welcome to my corner of the internet.&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;ul&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;li&amp;gt;&amp;lt;a href=\"https://github.com\"&amp;gt;GitHub&amp;lt;/a&amp;gt;&amp;lt;/li&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/ul&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;about-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"About"&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;About Me&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;I'm learning Clojure and building my first website!&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;str&lt;/code&gt; shows up again here, joining the lines of each body into one piece of text before &lt;code&gt;page&lt;/code&gt; wraps it.&lt;/p&gt;

&lt;p&gt;Put your real name and real links in &lt;code&gt;home-page&lt;/code&gt;.&lt;br&gt;
Nothing changes in the browser yet. In the next step we'll connect these pages to addresses so you can see them.&lt;/p&gt;
&lt;h2&gt;
  
  
  Step 4: Show the right page
&lt;/h2&gt;

&lt;p&gt;You have two pages and one &lt;code&gt;handler&lt;/code&gt;. The handler needs to look at &lt;code&gt;:uri&lt;/code&gt;, which you saw in Step 1, and choose what page to show.&lt;/p&gt;

&lt;p&gt;Replace &lt;code&gt;handler&lt;/code&gt; with:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;case&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:uri&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/"&lt;/span&gt;&lt;span class="w"&gt;      &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt;
              &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/html"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
              &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;home-page&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/about"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt;
              &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/html"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
              &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;about-page&lt;/span&gt;&lt;span class="p"&gt;)}))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;(:uri req)&lt;/code&gt; looks up the key &lt;code&gt;:uri&lt;/code&gt; in the request map. (It's a Clojure shortcut: a keyword in the first position looks itself up in the map that follows.)&lt;br&gt;
&lt;code&gt;case&lt;/code&gt; then picks the option that matches that value: &lt;code&gt;"/"&lt;/code&gt; gets the home page and &lt;code&gt;"/about"&lt;/code&gt; gets the about page.&lt;/p&gt;

&lt;p&gt;Restart and visit &lt;code&gt;/&lt;/code&gt; and &lt;code&gt;/about&lt;/code&gt;. You have a two-page website, with a navigation bar that works.&lt;/p&gt;

&lt;p&gt;It works, but look at the two response maps: they're identical except for the &lt;code&gt;:body&lt;/code&gt;.&lt;br&gt;
Add a third page and you'd copy it a third time, and a fourth, and so on.&lt;br&gt;
Whenever you catch yourself repeating the same work, consider moving it to a function so it can be reused.&lt;br&gt;
Here's a small helper function that builds the response map.&lt;br&gt;
The only thing that changes between pages, the body, becomes its input.&lt;br&gt;
Add it above &lt;code&gt;handler&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/html"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Now &lt;code&gt;handler&lt;/code&gt; can shrink to this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;case&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:uri&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/"&lt;/span&gt;&lt;span class="w"&gt;      &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;home-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/about"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;about-page&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Restart and visit both pages again: nothing changed for the visitor, and your code is less repetitive.&lt;br&gt;
The status is a parameter too, which is going to be handy in the next step.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Checkpoint:&lt;/strong&gt; your website now has more than one page.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;
  
  
  Step 5: Handle pages that don't exist
&lt;/h2&gt;

&lt;p&gt;Visit &lt;a href="http://localhost:8080/nothing-here" rel="noopener noreferrer"&gt;http://localhost:8080/nothing-here&lt;/a&gt;.&lt;br&gt;
Instead of something friendly, the browser shows &lt;code&gt;No matching clause: /nothing-here&lt;/code&gt;.&lt;br&gt;
&lt;code&gt;case&lt;/code&gt; needs a match, and there wasn't one, so the server gave up (and answered with status &lt;code&gt;500&lt;/code&gt;, the web's code for "something broke on the server").&lt;/p&gt;

&lt;p&gt;The fix is a catch-all as the last option: a page for "I don't know that one", with status &lt;code&gt;404&lt;/code&gt;, the web's code for "not found".&lt;br&gt;
Add &lt;code&gt;not-found-page&lt;/code&gt; above &lt;code&gt;handler&lt;/code&gt;, and replace &lt;code&gt;handler&lt;/code&gt; with the new version:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;not-found-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Not Found"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;404 - Page Not Found&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;case&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:uri&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/"&lt;/span&gt;&lt;span class="w"&gt;      &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;home-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/about"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;about-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;404&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;not-found-page&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Look at the last line of &lt;code&gt;case&lt;/code&gt;: it has only a result, with no match value in front of it.&lt;br&gt;
&lt;code&gt;case&lt;/code&gt; treats that as the default, the answer when nothing else matched.&lt;/p&gt;

&lt;p&gt;Restart and try &lt;code&gt;/nothing-here&lt;/code&gt; again.&lt;/p&gt;

&lt;p&gt;The 404 page looks like any other page, so how do you know the status really is &lt;code&gt;404&lt;/code&gt;? Your browser keeps track.&lt;br&gt;
Right-click the page, choose &lt;strong&gt;Inspect&lt;/strong&gt;, open the &lt;strong&gt;Network&lt;/strong&gt; tab and reload. The &lt;strong&gt;Status&lt;/strong&gt; column shows &lt;code&gt;404&lt;/code&gt; for &lt;code&gt;/nothing-here&lt;/code&gt;, and &lt;code&gt;200&lt;/code&gt; for &lt;code&gt;/&lt;/code&gt; and &lt;code&gt;/about&lt;/code&gt;.&lt;br&gt;
Status codes are mostly for machines, like browsers and search engines, which need to know what happened without reading the page.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Checkpoint:&lt;/strong&gt; your website now answers every address: with a page when it knows one, and with a friendly 404 when it doesn't.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;
  
  
  The whole file
&lt;/h2&gt;

&lt;p&gt;Here is the full &lt;code&gt;src/app/core.clj&lt;/code&gt; at this point. If something isn't working, compare yours to this one:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;ns&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;app.core&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;org.httpkit.server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:gen-class&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;!DOCTYPE html&amp;gt;&amp;lt;html&amp;gt;&amp;lt;head&amp;gt;&amp;lt;title&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/title&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;style&amp;gt;body{font-family:sans-serif;max-width:600px;margin:40px auto;padding:0 20px}"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"nav a{margin-right:12px}&amp;lt;/style&amp;gt;&amp;lt;/head&amp;gt;&amp;lt;body&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;nav&amp;gt;&amp;lt;a href=\"/\"&amp;gt;Home&amp;lt;/a&amp;gt;&amp;lt;a href=\"/about\"&amp;gt;About&amp;lt;/a&amp;gt;&amp;lt;/nav&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="w"&gt;
       &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/body&amp;gt;&amp;lt;/html&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;home-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Home"&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;Hi, I'm Carvalho&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;Welcome to my corner of the internet.&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;ul&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;li&amp;gt;&amp;lt;a href=\"https://github.com\"&amp;gt;GitHub&amp;lt;/a&amp;gt;&amp;lt;/li&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;/ul&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;about-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"About"&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;About Me&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="w"&gt;
             &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;p&amp;gt;I'm learning Clojure and building my first website!&amp;lt;/p&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;not-found-page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;page&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Not Found"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"&amp;lt;h1&amp;gt;404 - Page Not Found&amp;lt;/h1&amp;gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/html"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;case&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:uri&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;req&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/"&lt;/span&gt;&lt;span class="w"&gt;      &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;home-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s"&gt;"/about"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;about-page&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;html-response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;404&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;not-found-page&lt;/span&gt;&lt;span class="p"&gt;))))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;-main&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="o"&gt;&amp;amp;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;_args&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;Integer/parseInt&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;or&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;System/getenv&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"PORT"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"8080"&lt;/span&gt;&lt;span class="p"&gt;))]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;println&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Server running on port "&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;http/run-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="p"&gt;})))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Deploy it
&lt;/h2&gt;

&lt;p&gt;Same command as in Part 2:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;vercel deploy &lt;span class="nt"&gt;--prod&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Vercel remembers your project from last time, so it shouldn't ask you the setup questions again.&lt;br&gt;
Open the link and click around. Visit &lt;code&gt;/about&lt;/code&gt;, and then &lt;code&gt;/nothing-here&lt;/code&gt; to see your 404 page live.&lt;br&gt;
You didn't need to change &lt;code&gt;Dockerfile.vercel&lt;/code&gt; from Part 2: it copies the whole &lt;code&gt;src&lt;/code&gt; folder, so your new code goes along automatically.&lt;br&gt;
Your website is getting more interesting!&lt;/p&gt;

&lt;h2&gt;
  
  
  If something went wrong
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The browser shows old content&lt;/strong&gt;: the running program still has the old code. Stop the server with &lt;code&gt;Ctrl+C&lt;/code&gt;, start it again, and refresh.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Unable to resolve symbol: html-response&lt;/code&gt;&lt;/strong&gt; (or &lt;code&gt;home-page&lt;/code&gt;, &lt;code&gt;page&lt;/code&gt;...): Clojure reads the file from top to bottom, so a function has to be defined &lt;em&gt;above&lt;/em&gt; the code that uses it. Move it above &lt;code&gt;handler&lt;/code&gt;, and check the spelling of the name.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Syntax error reading source&lt;/code&gt; or &lt;code&gt;Unmatched delimiter&lt;/code&gt;&lt;/strong&gt;: a parenthesis is missing or extra. Remember the "Break it on purpose" section in Part 1: the line number in the error is where to start looking.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The page shows &lt;code&gt;&amp;lt;h1&amp;gt;&lt;/code&gt; and other tags as text&lt;/strong&gt;: the &lt;code&gt;Content-Type&lt;/code&gt; is still &lt;code&gt;text/plain&lt;/code&gt;. It has to be &lt;code&gt;text/html&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;No matching clause: /something&lt;/code&gt;&lt;/strong&gt;: &lt;code&gt;case&lt;/code&gt; didn't find a match and has no default. Add the last line from Step 5.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What you learned
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;The request is a map too: &lt;code&gt;:uri&lt;/code&gt; tells &lt;code&gt;handler&lt;/code&gt; which page the visitor asked for, and &lt;code&gt;:query-string&lt;/code&gt; holds what comes after the &lt;code&gt;?&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;Content-Type&lt;/code&gt; tells the browser how to read the response. &lt;code&gt;text/html&lt;/code&gt; makes it interpret the HTML tags.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;str&lt;/code&gt; joins pieces of text, and &lt;code&gt;page&lt;/code&gt; uses it to wrap any content in the same frame (title, styling, and navigation), so every page of your website looks similar.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;home-page&lt;/code&gt;, &lt;code&gt;about-page&lt;/code&gt; and &lt;code&gt;not-found-page&lt;/code&gt; are functions that return HTML text, and &lt;code&gt;handler&lt;/code&gt; uses &lt;code&gt;case&lt;/code&gt; to pick one based on &lt;code&gt;:uri&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;When you catch yourself repeating the same work, move it into a function. &lt;code&gt;html-response&lt;/code&gt; did that for the response map.&lt;/li&gt;
&lt;li&gt;A function has to be defined above the code that uses it.&lt;/li&gt;
&lt;li&gt;Status codes are part of the response: &lt;code&gt;200&lt;/code&gt; means OK and &lt;code&gt;404&lt;/code&gt; means not found. Without a default, &lt;code&gt;case&lt;/code&gt; fails and the server answers with a &lt;code&gt;500&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Next
&lt;/h2&gt;

&lt;p&gt;In the next part we'll make a page that responds to what a user types, and you'll finally put &lt;code&gt;:query-string&lt;/code&gt; from Step 1 to work.&lt;/p&gt;

</description>
      <category>beginners</category>
      <category>clojure</category>
      <category>programming</category>
      <category>tutorial</category>
    </item>
    <item>
      <title>Deploy your first Clojure website to Vercel (beginner-friendly)</title>
      <dc:creator>Thiago Carvalho</dc:creator>
      <pubDate>Mon, 26 Oct 2026 03:00:11 +0000</pubDate>
      <link>https://dev.to/thiagooak/learning-clojure-from-scratch-part-2-put-it-on-the-internet-55pb</link>
      <guid>https://dev.to/thiagooak/learning-clojure-from-scratch-part-2-put-it-on-the-internet-55pb</guid>
      <description>&lt;p&gt;This is part two of a series teaching Clojure to people with little or no programming experience.&lt;br&gt;
In Part 1 you built a small website and ran it on your computer.&lt;/p&gt;

&lt;p&gt;Right now the only person who can see your website is you.&lt;br&gt;
In this part we'll fix that.&lt;br&gt;
By the end you'll have a link you can open on your phone and send to a friend.&lt;/p&gt;

&lt;p&gt;The server code barely changes. Most of the work is teaching the &lt;em&gt;outside world&lt;/em&gt; how to run it.&lt;/p&gt;
&lt;h2&gt;
  
  
  What you need
&lt;/h2&gt;

&lt;p&gt;On top of what you have from Part 1:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A free &lt;a href="https://vercel.com/signup" rel="noopener noreferrer"&gt;Vercel account&lt;/a&gt;. Vercel is where your website will run.&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://nodejs.org/en/download" rel="noopener noreferrer"&gt;Node.js installed&lt;/a&gt; on your computer. We need it to install and run Vercel's command line tool.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;To check that Node is installed, run &lt;code&gt;npm --version&lt;/code&gt; in the terminal.&lt;/p&gt;

&lt;p&gt;Open your &lt;code&gt;my-site&lt;/code&gt; folder in VS Code and open a terminal (&lt;strong&gt;Terminal&lt;/strong&gt; &amp;gt; &lt;strong&gt;New Terminal&lt;/strong&gt;), just like last time.&lt;/p&gt;
&lt;h2&gt;
  
  
  Why a few things have to change
&lt;/h2&gt;

&lt;p&gt;On your computer, you run a command and the program runs.&lt;br&gt;
When someone else's computer runs it, three things need to be true:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;The program has to listen on whichever port &lt;em&gt;they&lt;/em&gt; tell it to, not the one you hard-coded.&lt;/li&gt;
&lt;li&gt;The program has to be bundled into a single file, so it can be copied around.&lt;/li&gt;
&lt;li&gt;They need a recipe that says how to build and start it.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;We'll take these one at a time, and after each one you can check that your website still works.&lt;/p&gt;
&lt;h2&gt;
  
  
  Step 1: Let the outside world choose the port
&lt;/h2&gt;

&lt;p&gt;In Part 1, you hard-coded the port as &lt;code&gt;8080&lt;/code&gt; (&lt;code&gt;(http/run-server handler {:port 8080})&lt;/code&gt;). Vercel requires that your program use a port they define in an &lt;em&gt;environment variable&lt;/em&gt;.&lt;/p&gt;

&lt;p&gt;Environment variables live outside your code, and you can look them up by name.&lt;br&gt;
The one you'll use is called &lt;code&gt;PORT&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Replace &lt;code&gt;-main&lt;/code&gt; in &lt;code&gt;src/app/core.clj&lt;/code&gt; with:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;-main&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="o"&gt;&amp;amp;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;_args&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;let&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;Integer/parseInt&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;or&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;System/getenv&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"PORT"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"8080"&lt;/span&gt;&lt;span class="p"&gt;))]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;println&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Server running on port "&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;http/run-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;port&lt;/span&gt;&lt;span class="p"&gt;})))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Read it from the inside out:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;(System/getenv "PORT")&lt;/code&gt; asks "is there an environment variable called &lt;code&gt;PORT&lt;/code&gt;?" You get its value, or &lt;code&gt;nil&lt;/code&gt; (nothing) if there isn't one.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;(or ... "8080")&lt;/code&gt; means "use &lt;code&gt;PORT&lt;/code&gt;, or (if &lt;code&gt;PORT&lt;/code&gt; is nil) use &lt;code&gt;"8080"&lt;/code&gt; instead".&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;(Integer/parseInt ...)&lt;/code&gt; turns the text &lt;code&gt;"8080"&lt;/code&gt; into the number &lt;code&gt;8080&lt;/code&gt;. Environment variables are always text, so we have to convert.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;let&lt;/code&gt; gives a name to a value, so &lt;code&gt;port&lt;/code&gt; refers to either the value of &lt;code&gt;PORT&lt;/code&gt; or &lt;code&gt;8080&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Run it (&lt;code&gt;clojure -M:run&lt;/code&gt;) and open &lt;code&gt;localhost:8080&lt;/code&gt;. Nothing changed, because &lt;code&gt;PORT&lt;/code&gt; was never defined.&lt;/p&gt;

&lt;p&gt;Now stop the server (&lt;code&gt;Ctrl+C&lt;/code&gt;) and start it with a port of your choosing:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;PORT&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;3000 clojure &lt;span class="nt"&gt;-M&lt;/span&gt;:run
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;(On Windows PowerShell this would be &lt;code&gt;$env:PORT=3000; clojure -M:run&lt;/code&gt;.)&lt;/p&gt;

&lt;p&gt;The terminal now says &lt;code&gt;Server running on port 3000&lt;/code&gt;.&lt;br&gt;
Your website is now running at &lt;code&gt;localhost:3000&lt;/code&gt;. It adapts to its environment.&lt;/p&gt;

&lt;p&gt;Stop the server again with &lt;code&gt;Ctrl+C&lt;/code&gt;.&lt;/p&gt;
&lt;h2&gt;
  
  
  Step 2: Bundle it into one file
&lt;/h2&gt;

&lt;p&gt;Right now your program is a folder of source files plus a set of libraries that &lt;code&gt;clojure&lt;/code&gt; downloads on demand.&lt;br&gt;
To copy it to another machine, we want a single file with everything inside.&lt;br&gt;
In the Java world that file is called a &lt;em&gt;jar&lt;/em&gt;, and one that contains everything is called an &lt;em&gt;uberjar&lt;/em&gt;.&lt;/p&gt;

&lt;p&gt;We need three changes to create an &lt;em&gt;uberjar&lt;/em&gt;.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;First&lt;/strong&gt;, add &lt;code&gt;(:gen-class)&lt;/code&gt; to the &lt;code&gt;ns&lt;/code&gt; at the top of &lt;code&gt;src/app/core.clj&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;ns&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;app.core&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;org.httpkit.server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:gen-class&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This tells Java that this file can be the starting point of a packaged program.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Second&lt;/strong&gt;, replace &lt;code&gt;deps.edn&lt;/code&gt; with this. The only new part is the &lt;code&gt;:build&lt;/code&gt; alias:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:paths&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;"src"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:deps&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;org.clojure/clojure&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:mvn/version&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"1.12.0"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="n"&gt;http-kit/http-kit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:mvn/version&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"2.8.0"&lt;/span&gt;&lt;span class="p"&gt;}}&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:aliases&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:run&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:main-opts&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;"-m"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"app.core"&lt;/span&gt;&lt;span class="p"&gt;]}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="no"&gt;:build&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:deps&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;io.github.clojure/tools.build&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:mvn/version&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"0.10.5"&lt;/span&gt;&lt;span class="p"&gt;}}&lt;/span&gt;&lt;span class="w"&gt;
          &lt;/span&gt;&lt;span class="no"&gt;:ns-default&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;build&lt;/span&gt;&lt;span class="p"&gt;}}}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;:run&lt;/code&gt; is still a shortcut for starting the program. &lt;code&gt;:build&lt;/code&gt; is a shortcut for a tool, &lt;code&gt;tools.build&lt;/code&gt;, that knows how to bundle a program.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Third&lt;/strong&gt;, create a file called &lt;code&gt;build.clj&lt;/code&gt; in the root of the project (next to &lt;code&gt;deps.edn&lt;/code&gt;, not inside &lt;code&gt;src&lt;/code&gt;):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;ns&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;build&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;clojure.tools.build.api&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;]))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;def&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;class-dir&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"target/classes"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;def&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;uber-file&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"target/app.jar"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;def&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;basis&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;delay&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;b/create-basis&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:project&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"deps.edn"&lt;/span&gt;&lt;span class="p"&gt;})))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;uber&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;_&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;b/delete&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:path&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"target"&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;b/copy-dir&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:src-dirs&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;"src"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:target-dir&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;class-dir&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;b/compile-clj&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:basis&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;@&lt;/span&gt;&lt;span class="n"&gt;basis&lt;/span&gt;&lt;span class="w"&gt;
                  &lt;/span&gt;&lt;span class="no"&gt;:src-dirs&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;"src"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
                  &lt;/span&gt;&lt;span class="no"&gt;:class-dir&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;class-dir&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;b/uber&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:class-dir&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;class-dir&lt;/span&gt;&lt;span class="w"&gt;
           &lt;/span&gt;&lt;span class="no"&gt;:uber-file&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;uber-file&lt;/span&gt;&lt;span class="w"&gt;
           &lt;/span&gt;&lt;span class="no"&gt;:basis&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;@&lt;/span&gt;&lt;span class="n"&gt;basis&lt;/span&gt;&lt;span class="w"&gt;
           &lt;/span&gt;&lt;span class="no"&gt;:main&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="ss"&gt;'app.core&lt;/span&gt;&lt;span class="p"&gt;}))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This is a program whose job is to build your program.&lt;br&gt;
Read the steps in &lt;code&gt;uber&lt;/code&gt; in order and you'll get the idea: delete the old &lt;code&gt;target&lt;/code&gt; folder, copy the source in, compile it, and pack it together with all the libraries into &lt;code&gt;target/app.jar&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Now build it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;clojure &lt;span class="nt"&gt;-T&lt;/span&gt;:build uber
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The first time, Clojure downloads the build tool, so it can take a minute. It prints nothing when it succeeds. Check that &lt;code&gt;target/app.jar&lt;/code&gt; appeared in the file explorer.&lt;/p&gt;

&lt;p&gt;Then run the jar directly:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;java &lt;span class="nt"&gt;-jar&lt;/span&gt; target/app.jar
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Open &lt;code&gt;localhost:8080&lt;/code&gt;. You should see &lt;code&gt;Hello, World!&lt;/code&gt;.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Checkpoint:&lt;/strong&gt; this is exactly what Vercel will do with your project. If it works here, the hard part is done.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Stop the server with &lt;code&gt;Ctrl+C&lt;/code&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: Write the recipe
&lt;/h2&gt;

&lt;p&gt;Create a file called &lt;code&gt;Dockerfile.vercel&lt;/code&gt; in the root of the project:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight docker"&gt;&lt;code&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;clojure:temurin-21-tools-deps&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;AS&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;build&lt;/span&gt;
&lt;span class="k"&gt;WORKDIR&lt;/span&gt;&lt;span class="s"&gt; /app&lt;/span&gt;
&lt;span class="k"&gt;COPY&lt;/span&gt;&lt;span class="s"&gt; deps.edn build.clj .&lt;/span&gt;
&lt;span class="k"&gt;COPY&lt;/span&gt;&lt;span class="s"&gt; src src&lt;/span&gt;
&lt;span class="k"&gt;RUN &lt;/span&gt;clojure &lt;span class="nt"&gt;-T&lt;/span&gt;:build uber

&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="s"&gt; eclipse-temurin:21-jre-alpine&lt;/span&gt;
&lt;span class="k"&gt;COPY&lt;/span&gt;&lt;span class="s"&gt; --from=build /app/target/app.jar /app.jar&lt;/span&gt;
&lt;span class="k"&gt;CMD&lt;/span&gt;&lt;span class="s"&gt; ["/opt/java/openjdk/bin/java", "-jar", "/app.jar"]&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This is the recipe Vercel follows to build and run your program.&lt;br&gt;
Vercel looks for a file with exactly this name, and runs the result.&lt;/p&gt;

&lt;p&gt;You don't need to understand the details of this file right now. Its shape is what matters. It has two parts, each starting with &lt;code&gt;FROM&lt;/code&gt;:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Build.&lt;/strong&gt; Start from a machine that has Clojure installed, copy in &lt;code&gt;deps.edn&lt;/code&gt;, &lt;code&gt;build.clj&lt;/code&gt; and &lt;code&gt;src&lt;/code&gt;, and run: &lt;code&gt;clojure -T:build uber&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Run.&lt;/strong&gt; Start from a much smaller machine that has only Java, copy in &lt;code&gt;app.jar&lt;/code&gt;, and start it using &lt;code&gt;java -jar app.jar&lt;/code&gt;.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;
  
  
  Step 4: Leave some things out
&lt;/h2&gt;

&lt;p&gt;Create two more files in the root of the project.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;.dockerignore&lt;/code&gt; lists things that shouldn't be sent to the build machine:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;.git
.gitignore
target
.cpcache
README.md
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;.gitignore&lt;/code&gt; lists things you don't want to save into version control (when you start using Git, it will skip these):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;.cpcache/
.clj-kondo/
.lsp/
target/
.vercel/
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Step 5: Write some documentation
&lt;/h2&gt;

&lt;p&gt;Add one more file called &lt;code&gt;README.md&lt;/code&gt; so future-you remembers what this folder is:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight markdown"&gt;&lt;code&gt;&lt;span class="gh"&gt;# My Clojure website&lt;/span&gt;

Built following the "Learning Clojure from Scratch" series.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Your project should now look like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;my-site/
  .dockerignore
  .gitignore
  Dockerfile.vercel
  README.md
  build.clj
  deps.edn
  src/
    app/
      core.clj
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If you compare it with &lt;a href="https://github.com/thiagooak/vercel-clojure" rel="noopener noreferrer"&gt;&lt;code&gt;vercel-clojure&lt;/code&gt;&lt;/a&gt;, the template this series is based on, you'll find the same files. But you wrote them yourself, and you know why each one is there.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 6: Deploy
&lt;/h2&gt;

&lt;p&gt;Install Vercel's command line tool:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm i &lt;span class="nt"&gt;-g&lt;/span&gt; vercel
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Log in. This opens your browser to confirm who you are:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;vercel login
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;In your browser, Vercel asks you to authorize your device. Once you do (you'll see a message like "Congratulations! You are now signed in."), run the command below to deploy:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;vercel deploy &lt;span class="nt"&gt;--prod&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The first time, Vercel asks a few questions about your project. When asked "Which project?", select "Create a new project". For the other questions, the suggested answers are usually fine. After you answer all of the questions, Vercel will build and deploy your website.&lt;/p&gt;

&lt;p&gt;When it finishes you'll get a link that ends in &lt;code&gt;vercel.app&lt;/code&gt;.&lt;br&gt;
Open it. You should see &lt;code&gt;Hello, World!&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;That's your program, running in the cloud, reachable from anywhere in the world.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Checkpoint:&lt;/strong&gt; open the link on your phone or another computer.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  If something went wrong
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;vercel: command not found&lt;/code&gt;&lt;/strong&gt;: the install in Step 6 didn't finish, or your terminal needs to be reopened.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The build fails on Vercel&lt;/strong&gt;: the output in the terminal shows the failing line. The most common cause is a typo in &lt;code&gt;build.clj&lt;/code&gt; or &lt;code&gt;Dockerfile.vercel&lt;/code&gt;. If &lt;code&gt;clojure -T:build uber&lt;/code&gt; works on your computer, the build step should work on Vercel.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The link shows an error page&lt;/strong&gt;: first check that &lt;code&gt;java -jar target/app.jar&lt;/code&gt; works locally. If it does, run &lt;code&gt;vercel logs&lt;/code&gt; with your deployment's link to see what your program printed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The link asks you to log in to Vercel&lt;/strong&gt;: Vercel can protect some of the links it creates so only you can see them. Open the link labelled &lt;em&gt;Production&lt;/em&gt; in the output of &lt;code&gt;vercel deploy --prod&lt;/code&gt;, or find your project in the Vercel dashboard and use its production domain.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What you learned
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Your program now reads its port from an environment variable (&lt;code&gt;PORT&lt;/code&gt;) and falls back to &lt;code&gt;8080&lt;/code&gt; when there isn't one, so the same code works on your computer and on Vercel.&lt;/li&gt;
&lt;li&gt;An &lt;em&gt;uberjar&lt;/em&gt; is a single file with your code and all of its libraries. &lt;code&gt;clojure -T:build uber&lt;/code&gt; creates it and &lt;code&gt;java -jar target/app.jar&lt;/code&gt; runs it.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;build.clj&lt;/code&gt; is a small program whose job is to build your program, and the &lt;code&gt;:build&lt;/code&gt; alias in &lt;code&gt;deps.edn&lt;/code&gt; is how you call it.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;Dockerfile.vercel&lt;/code&gt; is the recipe Vercel follows: one stage builds the jar, the other runs it.&lt;/li&gt;
&lt;li&gt;Deploying means giving another computer a recipe and the files it needs. &lt;code&gt;vercel deploy --prod&lt;/code&gt; does that, and the result is a link anyone on the internet can open.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Next
&lt;/h2&gt;

&lt;p&gt;We'll stop saying "Hello, World!" and put your own words and pages on the website.&lt;/p&gt;

</description>
      <category>clojure</category>
      <category>webdev</category>
      <category>beginners</category>
      <category>vercel</category>
    </item>
    <item>
      <title>Learn Clojure from zero: build a tiny website in 15 minutes</title>
      <dc:creator>Thiago Carvalho</dc:creator>
      <pubDate>Mon, 26 Oct 2026 02:56:32 +0000</pubDate>
      <link>https://dev.to/thiagooak/learning-clojure-from-scratch-part-1-hello-world-5fhj</link>
      <guid>https://dev.to/thiagooak/learning-clojure-from-scratch-part-1-hello-world-5fhj</guid>
      <description>&lt;p&gt;This is part one of a series of blog posts that &lt;del&gt;tries to&lt;/del&gt; teaches you Clojure from scratch.&lt;br&gt;
It assumes that you have little or no experience with programming.&lt;/p&gt;

&lt;p&gt;By the end of the series you'll have your own Clojure website deployed to production:&lt;br&gt;
a homepage, an interactive page, and a blog.&lt;/p&gt;

&lt;p&gt;Some of it will be hard, and you won't understand everything we do to get there. Try to trust the process.&lt;br&gt;
My primary goal is to help you experience success early (in the form of having your own website)&lt;br&gt;
in the hope that it motivates you to continue your learning journey.&lt;br&gt;
If you are curious and persistent, you should be able to complete this. Good luck!&lt;/p&gt;

&lt;p&gt;In this first part we'll build a very small program and run it.&lt;/p&gt;
&lt;h2&gt;
  
  
  What you need
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;a href="https://clojure.org/guides/install_clojure" rel="noopener noreferrer"&gt;Clojure installed&lt;/a&gt; on your computer&lt;/li&gt;
&lt;li&gt;
&lt;a href="https://code.visualstudio.com/download" rel="noopener noreferrer"&gt;Visual Studio Code installed&lt;/a&gt; on your computer&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;To check that Clojure is installed, open a terminal and run:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;clojure &lt;span class="nt"&gt;--version&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If it prints a version number, you're ready.&lt;/p&gt;

&lt;p&gt;Clojure runs on the JVM (Java Virtual Machine), and the installation guide walks you through getting that too, so there is nothing extra to download if the command above works.&lt;br&gt;
This series is written with macOS and Linux terminals in mind, but Windows should work too.&lt;/p&gt;
&lt;h2&gt;
  
  
  Create a project folder
&lt;/h2&gt;

&lt;p&gt;Create an empty folder on your computer and call it &lt;code&gt;my-site&lt;/code&gt;.&lt;br&gt;
Open Visual Studio Code, click &lt;strong&gt;File&lt;/strong&gt; &amp;gt; &lt;strong&gt;Open Folder&lt;/strong&gt;, and choose &lt;code&gt;my-site&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;You'll see an empty file explorer on the left.&lt;br&gt;
Everything you make in this series will live here.&lt;/p&gt;

&lt;p&gt;Now click &lt;strong&gt;Terminal&lt;/strong&gt; &amp;gt; &lt;strong&gt;New Terminal&lt;/strong&gt;.&lt;br&gt;
A panel opens at the bottom of the window.&lt;br&gt;
A terminal is a place where you give your computer instructions by typing them.&lt;br&gt;
This one starts "inside" your &lt;code&gt;my-site&lt;/code&gt; folder, which is exactly where you want it.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Optional:&lt;/strong&gt; open the Extensions panel (the squares icon on the left), search for &lt;strong&gt;Calva&lt;/strong&gt;, and install it. It will make it easier to work with Clojure files and will allow you to do REPL-driven development in the future.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;
  
  
  Step 1: Tell Clojure about your project
&lt;/h2&gt;

&lt;p&gt;Create a new file called &lt;code&gt;deps.edn&lt;/code&gt; in the root of your project&lt;br&gt;
(hover over the file explorer and click the "New File" icon).&lt;br&gt;
Paste or type this in:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:paths&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;"src"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:deps&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;org.clojure/clojure&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:mvn/version&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"1.12.0"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
        &lt;/span&gt;&lt;span class="n"&gt;http-kit/http-kit&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:mvn/version&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"2.8.0"&lt;/span&gt;&lt;span class="p"&gt;}}&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="no"&gt;:aliases&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:run&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:main-opts&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s"&gt;"-m"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"app.core"&lt;/span&gt;&lt;span class="p"&gt;]}}}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You don't have to understand all of this yet, but here is a quick tour:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;:paths ["src"]&lt;/code&gt; says "my code lives in a folder called &lt;code&gt;src&lt;/code&gt;".&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;:deps&lt;/code&gt; lists the libraries this project uses. Clojure itself is one of them.
The other is &lt;a href="https://github.com/http-kit/http-kit" rel="noopener noreferrer"&gt;http-kit&lt;/a&gt;, a library that speaks HTTP, the language of web browsers.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;:aliases&lt;/code&gt; defines shortcuts. &lt;code&gt;:run&lt;/code&gt; is a shortcut that means "start the program whose entry point is called &lt;code&gt;app.core&lt;/code&gt;".&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The whole file is a &lt;em&gt;map&lt;/em&gt;: a collection of keys (the keywords starting with &lt;code&gt;:&lt;/code&gt;) and the values that go with them.&lt;/p&gt;

&lt;p&gt;Make sure to save the file before moving to the next step.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: Write the program
&lt;/h2&gt;

&lt;p&gt;Create a new file at &lt;code&gt;src/app/core.clj&lt;/code&gt;.&lt;br&gt;
That's a folder called &lt;code&gt;src&lt;/code&gt; (src is short for source), with a folder called &lt;code&gt;app&lt;/code&gt; inside it, with a file called &lt;code&gt;core.clj&lt;/code&gt; inside that.&lt;br&gt;
(If you type &lt;code&gt;src/app/core.clj&lt;/code&gt; as the file name, VS Code will create the folders for you.)&lt;/p&gt;

&lt;p&gt;The name &lt;code&gt;app.core&lt;/code&gt; in &lt;code&gt;deps.edn&lt;/code&gt; matches this path: &lt;code&gt;src/app/core.clj&lt;/code&gt;.&lt;br&gt;
Clojure uses the folders and file name to find your code.&lt;/p&gt;

&lt;p&gt;One thing to know before we start: Clojure uses lots of parentheses.&lt;br&gt;
Almost everything is written as &lt;code&gt;(something and-then-its-arguments)&lt;/code&gt;:&lt;br&gt;
the first word says what to do, and the rest is what to do it with.&lt;br&gt;
For example, &lt;code&gt;(println "Hello")&lt;/code&gt; means "print the text Hello".&lt;br&gt;
Every &lt;code&gt;(&lt;/code&gt; needs a matching &lt;code&gt;)&lt;/code&gt;, and the same goes for &lt;code&gt;[&lt;/code&gt; with &lt;code&gt;]&lt;/code&gt; and &lt;code&gt;{&lt;/code&gt; with &lt;code&gt;}&lt;/code&gt;.&lt;br&gt;
VS Code highlights matching pairs as you type, and if you lose one, Clojure will tell you. We'll try that on purpose near the end.&lt;/p&gt;

&lt;p&gt;We'll write the file in three small pieces.&lt;/p&gt;
&lt;h3&gt;
  
  
  Piece 1: Define a namespace and require some code
&lt;/h3&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;ns&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;app.core&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;org.httpkit.server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;]))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;&lt;code&gt;ns&lt;/code&gt; is short for &lt;em&gt;namespace&lt;/em&gt;.&lt;br&gt;
The first line of your Clojure file defines the namespace you are working on (&lt;code&gt;app.core&lt;/code&gt;) and the code it needs from other places in order to work.&lt;br&gt;
Here we require &lt;code&gt;org.httpkit.server&lt;/code&gt; from http-kit and give it the nickname &lt;code&gt;http&lt;/code&gt; so we don't have to type the long name every time.&lt;/p&gt;
&lt;h3&gt;
  
  
  Piece 2: Handle requests
&lt;/h3&gt;

&lt;p&gt;Add this at the bottom:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;_req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/plain"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="s"&gt;"Hello, World!"&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A website is like a conversation: a browser sends a &lt;em&gt;request&lt;/em&gt; and the server sends back a &lt;em&gt;response&lt;/em&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;   browser                        your program
  ---------                    ------------------
  GET /  ---- request ------&amp;gt;  handler
         &amp;lt;--- response ------  {:status 200 ...}
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;handler&lt;/code&gt; is the function that &lt;strong&gt;handles&lt;/strong&gt; what to send back.&lt;br&gt;
A &lt;em&gt;function&lt;/em&gt; is a named piece of code that takes something in, does some work, and gives something back.&lt;br&gt;
Here, &lt;code&gt;handler&lt;/code&gt; takes in the request and gives back the response.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;defn&lt;/code&gt; defines a function. Here you named it &lt;code&gt;handler&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;[_req]&lt;/code&gt; is the thing the function receives: the request from the browser.
The leading underscore is a convention that means "I'm not using this yet".&lt;/li&gt;
&lt;li&gt;The &lt;code&gt;{...}&lt;/code&gt; is a map that defines the response: &lt;code&gt;:status&lt;/code&gt; is a code (200 means "OK"), &lt;code&gt;:headers&lt;/code&gt; describes the format of the response, and &lt;code&gt;:body&lt;/code&gt; is what shows up on the screen.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Notice that in Clojure, calling a function returns whatever its last expression evaluates to. &lt;code&gt;handler&lt;/code&gt; returns the map with &lt;code&gt;:status&lt;/code&gt;, &lt;code&gt;:headers&lt;/code&gt; and &lt;code&gt;:body&lt;/code&gt;.&lt;/p&gt;
&lt;h3&gt;
  
  
  Piece 3: Create a main function and start the server
&lt;/h3&gt;

&lt;p&gt;Add this at the bottom:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;-main&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="o"&gt;&amp;amp;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;_args&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;println&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Server running on port 8080"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;http/run-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;8080&lt;/span&gt;&lt;span class="p"&gt;}))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;-main&lt;/code&gt; is the function that runs when you start your program.&lt;br&gt;
It prints a message, then starts a server with your &lt;code&gt;handler&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;&amp;amp; _args&lt;/code&gt; is for words typed after the program's name on the terminal. We're not using any, so ignore it for now.&lt;/p&gt;

&lt;p&gt;&lt;code&gt;8080&lt;/code&gt; is a &lt;em&gt;port&lt;/em&gt;, which you can think of as a numbered door on your computer.&lt;br&gt;
Browsers will knock on door 8080 to talk to your program.&lt;/p&gt;

&lt;p&gt;Here is the complete file:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight clojure"&gt;&lt;code&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;ns&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;app.core&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="no"&gt;:require&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;org.httpkit.server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="no"&gt;:as&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;]))&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;_req&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:status&lt;/span&gt;&lt;span class="w"&gt;  &lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:headers&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="s"&gt;"Content-Type"&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"text/plain"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
   &lt;/span&gt;&lt;span class="no"&gt;:body&lt;/span&gt;&lt;span class="w"&gt;    &lt;/span&gt;&lt;span class="s"&gt;"Hello, World!"&lt;/span&gt;&lt;span class="p"&gt;})&lt;/span&gt;&lt;span class="w"&gt;

&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;defn&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;-main&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="o"&gt;&amp;amp;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;_args&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;println&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;"Server running on port 8080"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;http/run-server&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;handler&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="no"&gt;:port&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;8080&lt;/span&gt;&lt;span class="p"&gt;}))&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Save it. Your project should now look like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;my-site/
  deps.edn
  src/
    app/
      core.clj
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Run it
&lt;/h2&gt;

&lt;p&gt;In the terminal at the bottom of VS Code, type this and hit enter:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;clojure &lt;span class="nt"&gt;-M&lt;/span&gt;:run
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The first time, Clojure downloads the libraries from &lt;code&gt;deps.edn&lt;/code&gt;. It can take a minute.&lt;br&gt;
When it's done you'll see the message:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Server running on port 8080
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The terminal now looks stuck, with no prompt coming back. That's correct: your server is running and waiting for visitors.&lt;/p&gt;

&lt;p&gt;Open &lt;a href="http://localhost:8080" rel="noopener noreferrer"&gt;http://localhost:8080&lt;/a&gt; in your browser.&lt;br&gt;
&lt;code&gt;localhost&lt;/code&gt; is a name that basically means "this computer".&lt;br&gt;
You should see:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Hello, World!
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Checkpoint:&lt;/strong&gt; you just wrote a program that serves a web page. It works only on your computer, but you created a real (and very simple) web page!&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  Change something
&lt;/h2&gt;

&lt;p&gt;Go back to &lt;code&gt;src/app/core.clj&lt;/code&gt; and change the body from &lt;code&gt;"Hello, World!"&lt;/code&gt; to &lt;code&gt;"Hello, Clojure!"&lt;/code&gt;. Save the file and refresh your browser.&lt;/p&gt;

&lt;p&gt;Nothing changed. That's expected: the running program loaded the old code and doesn't know that the file changed.&lt;br&gt;
Go to the terminal, press &lt;code&gt;Ctrl+C&lt;/code&gt; to stop the server, then run &lt;code&gt;clojure -M:run&lt;/code&gt; again and refresh the browser.&lt;/p&gt;

&lt;p&gt;This is the rhythm for the next few parts: &lt;strong&gt;edit, stop, start, refresh&lt;/strong&gt;.&lt;br&gt;
(Clojure has a smarter way of working called REPL-driven development. We'll start using it in a future post.)&lt;/p&gt;

&lt;h3&gt;
  
  
  Break it on purpose
&lt;/h3&gt;

&lt;p&gt;Reading errors is a good portion of programming, and it's easier when you know what broke. To get some practice, delete the very last character of the &lt;code&gt;:body&lt;/code&gt; line (the &lt;code&gt;)&lt;/code&gt; right after the &lt;code&gt;}&lt;/code&gt;), save, stop the server, and start it again.&lt;/p&gt;

&lt;p&gt;You'll get an error that starts with &lt;code&gt;Syntax error reading source&lt;/code&gt; and says &lt;code&gt;EOF while reading, starting at line 4&lt;/code&gt;.&lt;br&gt;
It's Clojure telling you "I reached the end of the file (EOF) and something that opened on line 4 was never closed".&lt;br&gt;
Line 4 is where &lt;code&gt;handler&lt;/code&gt; begins, so that's the place to look.&lt;br&gt;
Put the &lt;code&gt;)&lt;/code&gt; back, restart, and you're back in business.&lt;/p&gt;

&lt;p&gt;When you see a wall of error text, don't panic. The useful part is usually in the first or second line.&lt;/p&gt;

&lt;h2&gt;
  
  
  If something went wrong
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;clojure: command not found&lt;/code&gt;&lt;/strong&gt;: Clojure isn't installed yet, or the terminal was opened before the install finished. Close VS Code, reopen it, and try again.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;Address already in use&lt;/code&gt;&lt;/strong&gt;: another program, or an earlier run of this one, is using port 8080. You'll still see &lt;code&gt;Server running on port 8080&lt;/code&gt; just before the error, because the message prints before the server tries to claim the port. Find the terminal where it's still running and press &lt;code&gt;Ctrl+C&lt;/code&gt;. Alternatively, change your code to use another port (say 8081).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;An error mentioning &lt;code&gt;Could not locate app/core&lt;/code&gt;&lt;/strong&gt;: the file isn't at &lt;code&gt;src/app/core.clj&lt;/code&gt;. Check the folder and file names.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The browser says it can't connect&lt;/strong&gt;: the server isn't running. Look at the terminal for an error, or for the prompt coming back, which means the program exited.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What you learned
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Your website works like a conversation: a browser sends a request, and your program sends back a response.&lt;/li&gt;
&lt;li&gt;A function takes something in, does some work, and returns something. &lt;code&gt;handler&lt;/code&gt;, for example, takes the request and gives back a map describing the response.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;deps.edn&lt;/code&gt; says what the project needs and creates aliases (like &lt;code&gt;clojure -M:run&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;src/app/core.clj&lt;/code&gt; holds the code for your &lt;code&gt;handler&lt;/code&gt; (what to say) and &lt;code&gt;-main&lt;/code&gt; (the starting point).&lt;/li&gt;
&lt;li&gt;An error message is Clojure telling you where it got lost. Start reading the first and second lines before you panic.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Next
&lt;/h2&gt;

&lt;p&gt;In a future blog post we'll make &lt;code&gt;handler&lt;/code&gt; smarter and we'll make a few small changes so the same program can run on someone else's computer via the internet.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Bonus:&lt;/strong&gt; now that you are technically a Clojure developer, why not join the &lt;a href="http://clojurians.net" rel="noopener noreferrer"&gt;Clojurians community on Slack&lt;/a&gt;?&lt;/p&gt;
&lt;/blockquote&gt;

</description>
      <category>clojure</category>
      <category>webdev</category>
      <category>programming</category>
      <category>beginners</category>
    </item>
    <item>
      <title>Estimating Software Projects</title>
      <dc:creator>Thiago Carvalho</dc:creator>
      <pubDate>Sun, 12 Apr 2026 11:23:51 +0000</pubDate>
      <link>https://dev.to/thiagooak/estimating-software-projects-2m2d</link>
      <guid>https://dev.to/thiagooak/estimating-software-projects-2m2d</guid>
      <description>&lt;p&gt;Good estimates aren't just about predicting the future. They are mostly about making decisions with limited information.&lt;/p&gt;

&lt;p&gt;Estimating a project can be a big challenge. An estimate is nothing more than a guess about the amount of time it will take to do something. Still, bad estimates can waste a lot of time. In this blog post, I'll share ideas and techniques that can help you create good estimates, not because they are precise but because good estimations lead to &lt;em&gt;good decisions&lt;/em&gt;.&lt;/p&gt;

&lt;p&gt;We'll discuss how defining a clear goal before estimating helps you spend the right amount of effort estimating, how Fermi estimates can help you estimate complex questions, the benefits of breaking tasks into smaller parts, and the importance of communicating assumptions.&lt;/p&gt;

&lt;h2&gt;
  
  
  Start with clear goals
&lt;/h2&gt;

&lt;p&gt;First, define success in the context of the project.&lt;/p&gt;

&lt;p&gt;Estimating a project with a clear goal is hard. Estimating a project with an unclear goal is almost impossible. Vague definitions of success can lead to conversations where there is the illusion of alignment. People are talking about the same project, but each understands the goal differently.&lt;/p&gt;

&lt;p&gt;Vague definitions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Complete the Checkout Redesign&lt;/li&gt;
&lt;li&gt;Launch Checkout 2.0&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Clear definitions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Reduce the time users spend on the checkout from ~4 min to ~2 min by releasing a simpler checkout process that maintains or increases conversion rates.&lt;/li&gt;
&lt;li&gt;Implement new payment standard X before the regulatory deadline Y.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Second, define success in the context of the estimation.&lt;/p&gt;

&lt;p&gt;You could be estimating a project to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;decide if you should prioritize project A or project B&lt;/li&gt;
&lt;li&gt;understand if you need to ask for additional help&lt;/li&gt;
&lt;li&gt;make sure this change is released before a central bank deadline&lt;/li&gt;
&lt;li&gt;decide if you continue with the project given how much it will cost&lt;/li&gt;
&lt;li&gt;confirm that you'll need to ask for additional time or budget&lt;/li&gt;
&lt;li&gt;check if you have enough tickets for this Sprint&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The maximum amount of time you spend estimating and the precision of your estimates should depend on what you are estimating. The stakes of not completing a few extra tickets added to the Sprint are low compared to missing a regulatory deadline. Make sure you are not treating every estimation exercise exactly the same. Adapt your efforts to the context of what you are doing.&lt;/p&gt;

&lt;p&gt;There isn't a precise formula to define how much time and effort you should spend on each type of estimation. It depends on your context, but here are a few questions that can help you think about it:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;If my estimation is wrong, what's the worst that could happen?&lt;/li&gt;
&lt;li&gt;Based on the information I currently have, is my estimate reasonable?&lt;/li&gt;
&lt;li&gt;Once I have this estimation, how will it help me achieve the project's goals?&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Use Fermi estimates
&lt;/h2&gt;

&lt;p&gt;It is easy to become overwhelmed by data gaps when trying to get a perfect estimate.&lt;/p&gt;

&lt;p&gt;Often, the best way to get to a precise estimation is to start with an imprecise one. In some cases, you'll notice that the imprecise estimate is good enough and save the time you would have spent getting to a precise estimate.&lt;/p&gt;

&lt;p&gt;The &lt;a href="https://en.wikipedia.org/wiki/Fermi_problem" rel="noopener noreferrer"&gt;Fermi estimate&lt;/a&gt; is a great tool for getting a first estimate.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://www.youtube.com/watch?v=0YzvupOX8Is" rel="noopener noreferrer"&gt;This video&lt;/a&gt; has a visual explanation of this estimation technique.&lt;/p&gt;

&lt;p&gt;The classic Fermi estimate problem is "How many piano tuners are there in Chicago?"&lt;/p&gt;

&lt;p&gt;Before starting, note that you won't work with precise numbers. You'll work with order-of-magnitude estimates.&lt;/p&gt;

&lt;p&gt;Order-of-magnitude may seem complicated, but the idea is fairly simple. For example:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;100 is one order of magnitude larger than 10&lt;/li&gt;
&lt;li&gt;1000 is one order of magnitude smaller than 10000&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;It is common to represent these orders of magnitude as powers of 10. The examples above would look like this:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;10&lt;sup&gt;2&lt;/sup&gt; is one order of magnitude larger than 10&lt;sup&gt;1&lt;/sup&gt;
&lt;/li&gt;
&lt;li&gt;10&lt;sup&gt;3&lt;/sup&gt; is one order of magnitude smaller than 10&lt;sup&gt;4&lt;/sup&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;First, estimate the number of people living in Chicago. Note that you don't need to be sure if the number is closer to 1 million or 5 million people. Chicago is a fairly large city, so the answer is likely in the millions, or 1000000, or 10&lt;sup&gt;6&lt;/sup&gt;.&lt;/p&gt;

&lt;p&gt;Estimation:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Population of Chicago: 10&lt;sup&gt;6&lt;/sup&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Next, estimate how many people in Chicago have pianos. If we consider that 1 in every 100 people has a piano, we can divide our estimated population by 100 to get the number of pianos in Chicago: &lt;code&gt;1000000/100 = 10000&lt;/code&gt; or &lt;code&gt;10^6 / 10^2 = 10^4&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Estimations:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Population of Chicago: 10&lt;sup&gt;6&lt;/sup&gt;
&lt;/li&gt;
&lt;li&gt;Pianos in Chicago: 10&lt;sup&gt;4&lt;/sup&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Now, how many pianos are tuned in Chicago per year? 10, 100, or 1000? 10 seems too little. 1000 would mean tuning something like 3 pianos a day, which seems excessive. 100 seems to be a reasonable estimate.&lt;/p&gt;

&lt;p&gt;Estimations:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Population of Chicago: 10&lt;sup&gt;6&lt;/sup&gt;
&lt;/li&gt;
&lt;li&gt;Pianos in Chicago: 10&lt;sup&gt;4&lt;/sup&gt;
&lt;/li&gt;
&lt;li&gt;Pianos tuned in Chicago per year: 10&lt;sup&gt;2&lt;/sup&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Now you can divide the number of pianos by the number of pianos tuned in one year to get an estimate of the number of tuners in the city &lt;code&gt;pianos / pianos-tuned = piano-tuners&lt;/code&gt; or &lt;code&gt;10^4 / 10^2 = 10^2&lt;/code&gt;&lt;/p&gt;

&lt;p&gt;Estimations:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Population of Chicago: 10&lt;sup&gt;6&lt;/sup&gt;
&lt;/li&gt;
&lt;li&gt;Pianos in Chicago: 10&lt;sup&gt;4&lt;/sup&gt;
&lt;/li&gt;
&lt;li&gt;Pianos tuned in Chicago per year: 10&lt;sup&gt;2&lt;/sup&gt;
&lt;/li&gt;
&lt;li&gt;Piano tuners in Chicago: 10&lt;sup&gt;2&lt;/sup&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Following these steps, you estimated that there are roughly 100 piano tuners in Chicago. According to &lt;a href="https://www.youtube.com/watch?v=0YzvupOX8Is" rel="noopener noreferrer"&gt;Michael Mitchell's&lt;/a&gt; video, there are 81 piano tuners in Chicago, which is not a bad estimate.&lt;/p&gt;

&lt;p&gt;Fermi estimates generally work because your overestimates and underestimates tend to cancel each other out. Fermi estimates are not perfect, but they tend to give results within an order of magnitude of the right answer.&lt;/p&gt;

&lt;h2&gt;
  
  
  If something is hard to estimate, break it into smaller parts
&lt;/h2&gt;

&lt;p&gt;If you are having a hard time estimating a particular task, try breaking it down into smaller parts and estimating each part separately.&lt;/p&gt;

&lt;p&gt;For example, how long does it take to develop and publish an iOS weather app? It is pretty hard to estimate, so let's try breaking it down into smaller parts:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Get an Apple developer account&lt;/li&gt;
&lt;li&gt;Learn some Swift&lt;/li&gt;
&lt;li&gt;Design screens&lt;/li&gt;
&lt;li&gt;Find a weather API&lt;/li&gt;
&lt;li&gt;Integrate weather API&lt;/li&gt;
&lt;li&gt;Submit the app for approval&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;These smaller parts may not be comprehensive, but they are more concrete than the original question and easier to estimate.&lt;/p&gt;

&lt;p&gt;You can continue this process recursively until you reach a level of detail you are comfortable estimating.&lt;/p&gt;

&lt;h2&gt;
  
  
  Document and communicate assumptions
&lt;/h2&gt;

&lt;blockquote&gt;
&lt;p&gt;"Fixed targets struggle in a dynamic world" - Bjarte Bogsnes&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;It is unusual to start a project with all the information and resources you need, especially when innovating. When you communicate your estimate to your stakeholders, it is helpful to provide context for any assumptions.&lt;/p&gt;

&lt;p&gt;Imagine that you are estimating a project where:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Your project estimation assumes another team will deliver an important API next month.&lt;/li&gt;
&lt;li&gt;Your team does not have experience with C#, so you estimated the development time considering work you've done in another language plus some time for learning C#.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you don't share these assumptions with your stakeholders, it may give them an incorrect impression of the level of certainty in your estimate. Sharing these early creates more realistic expectations and simplifies future conversations (for example, if the other team delays the delivery of the API).&lt;/p&gt;

&lt;p&gt;It is okay not to know everything and to make assumptions. Just make sure you communicate with them.&lt;/p&gt;

&lt;h2&gt;
  
  
  Summary
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Have a clear goal to avoid the illusion of alignment (where each person understands the project goal differently).&lt;/li&gt;
&lt;li&gt;Fermi estimates are a helpful tool, you can use powers of 10 to arrive at good rough estimates without using precise numbers.&lt;/li&gt;
&lt;li&gt;Break tasks into smaller parts.&lt;/li&gt;
&lt;li&gt;Communicating assumptions.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Resources
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.youtube.com/watch?v=D86wG5u-E14" rel="noopener noreferrer"&gt;The State of NoEstimates - Woody Zuill&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.youtube.com/watch?v=7tsu0E33Krc" rel="noopener noreferrer"&gt;Beyond Budgeting - Bjarte Bogsnes&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.etymonline.com/word/estimation" rel="noopener noreferrer"&gt;Estimation (n.)&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;This article was originally published on my blog: &lt;a href="https://tcds.dev/blog/estimating-software-projects" rel="noopener noreferrer"&gt;https://tcds.dev/blog/estimating-software-projects&lt;/a&gt;&lt;/p&gt;

</description>
      <category>softwareengineering</category>
      <category>estimation</category>
      <category>planning</category>
    </item>
    <item>
      <title>Improving onboarding. What socialization traits signal that some might quit?</title>
      <dc:creator>Thiago Carvalho</dc:creator>
      <pubDate>Thu, 20 Jan 2022 13:32:57 +0000</pubDate>
      <link>https://dev.to/thiagooak/improving-onboarding-what-socialization-traits-signal-that-some-might-quit-5oj</link>
      <guid>https://dev.to/thiagooak/improving-onboarding-what-socialization-traits-signal-that-some-might-quit-5oj</guid>
      <description>&lt;p&gt;Guided interaction can help you improve your onboarding. Lack of knowledge about company goals, values, and history may indicate someone about to quit. Defining the Zone of Proximal Development.&lt;/p&gt;

&lt;h2&gt;
  
  
  Improving onboarding
&lt;/h2&gt;

&lt;p&gt;I recently read Krystal Higgins’ book “Better Onboarding”. It focuses on Product Onboarding, but I believe the same ideas can be applied to Employee Onboarding.&lt;/p&gt;

&lt;p&gt;Some of my favorite parts of the book:&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;A great definition of onboarding&lt;/strong&gt;&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;“onboarding isn’t a single moment, or a single feature, or a single flow. It’s a process that connects many activities, over time, to bridge the gap between trying a new product and becoming a core user of it. Tutorials, videos, setup flows, slideshows, and signup flows may all be a part of that journey, but none alone are the journey.” [1]&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;strong&gt;A big challenge when onboarding someone is “the paradox of the active user”&lt;/strong&gt;&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;“new users were motivated by the specific goals they wanted to achieve, not by the larger potential of the technology. They were uninterested in taking time up front to learn about all the features they might benefit from in the future when there were actions they could definitely benefit from immediately. As a result, each person’s understanding of what this software was capable of was often limited to the tasks they did first. Rosson and Carroll called this a paradox because people could get more from software if they spent time learning about it up front. However, we can’t design for this because people don’t behave in such an idealized way.”&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;strong&gt;Now what?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;The book presents a solution called guided interaction. It defines guided interaction as:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;“[weaving] guidance into the key interactions of our products so new users can immerse themselves in our experience, and have the support they need to be successful”&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;The author also shares a handy visualization of Onboarding Actions (below) where you:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Define your Core Use (e.g. places one order every week, pushes 5 commits per month).&lt;/li&gt;
&lt;li&gt;Set your entry situations (which is an entry point + the context of the user at that point).&lt;/li&gt;
&lt;li&gt;Work from the center to the edges defining what needs to happen so that a user navigates from the entry situation to the desired Core Use.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F3viqok1llnb1tc3ye2wj.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F3viqok1llnb1tc3ye2wj.png" alt=" " width="800" height="765"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;It is a well-written and insightful book that I definitely recommend (you can find it &lt;a href="https://abookapart.com/products/better-onboarding" rel="noopener noreferrer"&gt;here&lt;/a&gt;). If reading is not your main form of learning, try watching one of Krystal Higgins’ talks &lt;a href="https://www.youtube.com/watch?v=nOYbLeuuJko" rel="noopener noreferrer"&gt;https://www.youtube.com/watch?v=nOYbLeuuJko&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  What socialization traits signal that some might quit?
&lt;/h2&gt;

&lt;p&gt;“For this review the following six dimensions of organizational socialization were conceptualized and developed”[2]&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Performance Proficiency&lt;/li&gt;
&lt;li&gt;People&lt;/li&gt;
&lt;li&gt;Politics&lt;/li&gt;
&lt;li&gt;Language&lt;/li&gt;
&lt;li&gt;Organizational Goals and Values&lt;/li&gt;
&lt;li&gt;History&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;For 5 years the researchers kept in touch with a group of people that worked in Engineering or Engineering Management jobs. They found that a low rating on &lt;strong&gt;Organizational Goals and Values&lt;/strong&gt; and &lt;strong&gt;History&lt;/strong&gt; in one year “may signal readiness to move to another organization” in the following year.&lt;/p&gt;

&lt;p&gt;Organizational Goals and Values were defined as “learning of specific organizational goals and values. […] also extends to unwritten, informal, tacit goals and values espoused by members who are in powerful or controlling positions”&lt;/p&gt;

&lt;p&gt;History was defined as “how an organization’s traditions, customs, myths, and rituals are used to transmit cultural knowledge and perpetuate a particular type of organizational member”&lt;/p&gt;

&lt;h2&gt;
  
  
  The Zone of Proximal Development (aka the ZPD).
&lt;/h2&gt;

&lt;blockquote&gt;
&lt;p&gt;“The zone of proximal development is the distance between what a person can do with and without help.” [3]&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Learning happens in the space between what is too easy and what is too hard. This might intuitively make sense to most people, nevertheless, it is nice to know how the cool kids educational researchers call this space, the ZPD.&lt;/p&gt;

&lt;p&gt;[1] &lt;a href="https://abookapart.com/products/better-onboarding" rel="noopener noreferrer"&gt;Better Onboarding, Krystal Higgins&lt;/a&gt; &lt;br&gt;
[2] &lt;a href="//www.researchgate.net/publication/232462733_Organizational_Socialization_Its_Content_and_Consequences"&gt;Organizational Socialization: It’s Content and Consequences&lt;/a&gt;&lt;br&gt;
[3] &lt;a href="//www.researchgate.net/publication/267778614_Understanding_Scaffolding_and_the_ZPD_in_Educational_Research"&gt;Understanding Scaffolding and the ZPD in Educational Research&lt;/a&gt;&lt;/p&gt;

</description>
      <category>leadership</category>
      <category>onboarding</category>
      <category>education</category>
    </item>
  </channel>
</rss>
