Scala Projects course content (#346)

daniel-ciocirlan · web-flow · commit 8869579e609b · 2025-09-17T18:15:11.000+03:00
* scala projects content

* formatted images

* ragnarok

* haoyi description

* spelling whitelist
diff --git a/.trunk/configs/.codespellrc b/.trunk/configs/.codespellrc
@@ -1,3 +1,3 @@
 [codespell]
 skip = *.svg,*.xsl
-ignore-words-list = assertIO,aNumber,optionA,OptIn,compiletime,launchIn,shouldBe,RIn,Absolut
+ignore-words-list = assertIO,aNumber,optionA,OptIn,compiletime,launchIn,shouldBe,RIn,Absolut,Statick
diff --git a/src/collections/courses.ts b/src/collections/courses.ts
@@ -71,6 +71,7 @@ export default defineCollection({
             three: image().optional(),
             four: image().optional(),
             five: image().optional(),
+            six: image().optional(),
           })
           .strict()
           .optional(),
diff --git a/src/data/authors/li-haoyi/index.yaml b/src/data/authors/li-haoyi/index.yaml
@@ -0,0 +1,7 @@
+biography: Haoyi Li is a software engineer and the author of com-lihaoyi, an ecosystem of popular open-source Scala libraries, including os-lib, uPickle, Cask and Scalatags. He also recently released the 1.0 version of his improved Mill build tool, and is is the author of the book Hands-On Scala Programming.
+name: Haoyi Li
+photo: ./photo.png
+socials:
+  email: haoyi.sg@gmail.com
+  github: lihaoyi
+  website: https://www.lihaoyi.com/
diff --git a/src/data/authors/li-haoyi/photo.png b/src/data/authors/li-haoyi/photo.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a9d3f64f8d9501dc1a93678112042a574b404f2d4a27d2c6492eb36e2c80b9d7
+size 290336
diff --git a/src/data/courses/scala-projects/images/ai.png b/src/data/courses/scala-projects/images/ai.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f527dd9abbd1eda6c551e0750194f0d7fcabb63ca0a7e50384bceb2460723fa4
+size 226110
diff --git a/src/data/courses/scala-projects/images/chattie.png b/src/data/courses/scala-projects/images/chattie.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f1bd3ee9dbdd0f536c574e8882b5308c3804e0fa290e6c19eb42efc93668b877
+size 189031
diff --git a/src/data/courses/scala-projects/images/photoscala.png b/src/data/courses/scala-projects/images/photoscala.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0300a0fcec152215a8f03abbb51e2bb7cc779b4268da7d4a68ddad6794d9f9d4
+size 751741
diff --git a/src/data/courses/scala-projects/images/scaladrive.png b/src/data/courses/scala-projects/images/scaladrive.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:37e682012eebaf5a24f672da4f99db6377c3999b701008cb0f973f3d9ded6671
+size 262632
diff --git a/src/data/courses/scala-projects/images/scrapeyard.png b/src/data/courses/scala-projects/images/scrapeyard.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:03b9677f3502a010653def082d87bf27f3c92f6b895f5455428442924e131b2e
+size 502464
diff --git a/src/data/courses/scala-projects/images/statick.png b/src/data/courses/scala-projects/images/statick.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:56aeb52b225f72566fdd92542d49e99f4a0fe233eca0ba004bc4ea50f270b4f9
+size 285789
diff --git a/src/data/courses/scala-projects/index.mdx b/src/data/courses/scala-projects/index.mdx
@@ -1,17 +1,26 @@
 ---
+title: Scala Projects
+publishedDate: 2025-09-17
+description: Learn and practice Scala with real-life projects. Ideal for developers who have just learned the fundamentals of Scala, and want to get practical experience by building real applications.
 benefits:
-    hours: 12
-    linesOfCode: 3000
+    hours: 15
+    linesOfCode: 3300
 category: scala
-description: Learn and practice Scala with real-life projects. Ideal for developers who have just learned the fundamentals of Scala, and want to get practical experience by building real applications.
 difficulty: intermediate
 excerpt: <p>Get practical experience with Scala by building real things &mdash; file synchronizers, photo processors, AI agents and more</p>
 heroImage: images/scala-projects.png
-title: Scala Projects
-isPreview: true
 pricingPlanId: 6340608
-publishedDate: 2025-09-01
 tags: [scala, project]
+features:
+  one: images/photoscala.png
+  two: images/scrapeyard.png
+  three: images/statick.png
+  four: images/chattie.png
+  five: images/scaladrive.png
+  six: images/ai.png
+collaborators:
+  - author: li-haoyi
+    biography: <p>Haoyi Li is a software engineer and the author of com-lihaoyi, an ecosystem of popular open-source Scala libraries, including os-lib, uPickle, Cask and Scalatags, which we used in this course. He is also the author of the book Hands-On Scala Programming, which he gracefully allowed me to use as an inspiration for 4 out of 6 projects of this course. I took his code examples in the book to a more "product-like" state, with refactorings and a more functional-style Scala, so that the total overlap with his book is about 30%. You'll get a lot of value from this course even if (especially if) you have his book close by.</p><p>Haoyi is also the creator of the Mill build tool, which he recently released as 1.0.</p>
 ---
 
 import CourseLayout from "@/pages/courses/_layouts/CourseLayout.astro";
@@ -27,43 +36,109 @@ Maybe you'd like to start building your own projects, but you don't know where t
 This course is for you. In here, you will build real applications with Scala, from scratch. Maybe one of them will be the starting point for your next startup.
 
 </Fragment>
+
+<Fragment slot="verticalSection">
+
+<br/>
+Each project takes about 2 hours to complete - enough for an evening hack session - but with plenty of room for expanding into something more serious if you like the project or want to use it yourself.
+
+At the beginning of every project, you'll get a tutorial on the libraries we'll use, then we'll go lasers blazing into the project itself.
+
+Let me tell you about the projects:
+
+</Fragment>
+
 <Fragment slot="skills">
 ### After this course, you'll be able to:
 - use Scala as a fast, productive language for the task at hand
 - pick the right tools and libraries for a Scala project
 - use either plain Scala or straightforward libraries (instead of effect systems or magical frameworks) for powerful applications
 - deploy your Scala applications to the target of your choice
+- hopefully, use the projects you've built or turn them into real products!
+</Fragment>
+
+<Fragment slot="feature1">
+### Project 1: PhotoScala
+This is a command-line image editor, which can transform pictures in various ways. You can crop, resize, apply filters and effects, and combine multiple images together.
+
+We architect this app so that you can add as many other transformations, effects and filters as you want. The code is modular and easy to extend.
+
+You'll learn
+
+- how to work with pictures
+- image effects
+- blend modes (the kind of stuff you see in Photoshop)
+- kernel filters like blur, sharpen, emboss and edge detection
+- not least, how to build a command line
+</Fragment>
+
+<Fragment slot="feature2">
+### Project 2: ScrapeYard
+
+This is a web scraper, which can scrape any website and extract useful information from it. You can use it to scrape news articles, product information, or any other kind of data.
+
+We'll write different scrapers for different sites (including Rock the JVM!), and by the end of this project we'll be able to extract news headlines from a popular site and send them to you over email, instead of endless doom-scrolling.
+
+You'll learn
+
+- parsing real websites
+- recursive scraping (e.g. on forums)
+- parallel crawling
+- sending emails
+</Fragment>
+
+<Fragment slot="feature3">
+### Project 3: Statick
+In this project, we'll build a static site generator.
+
+By the end of this chapter, you'll have a personal Markdown-based programming blog deployed on GitHub Pages, with syntax highlighting and all.
+
+It takes far less code than you think, it looks great and you can expand it into a full-blown framework if you want.
+
+You'll learn
+
+- static site rendering
+- deploying a website to a popular hosting platform
+- adding configuration
+- syntax highlighting
+- templating
+</Fragment>
+
+<Fragment slot="feature4">
+### Project 4: Chattie
+
+This is a full-stack Scala application in the style of WhatsApp. Multiple users can connect to a chat room, and send messages and replies, with persistent storage. When a user logs in, they see the full chat history.
+
+You'll learn
+
+- using databases
+- exposing web servers
+- frontend with ScalaJS
+- sharing domain model (so underrated!)
+- real-time updates with websockets
+</Fragment>
+
+<Fragment slot="feature5">
+### Project 5: ScalaDrive
+This is a real-time file synchronizer. Works real fast: I try cloning my big Typelevel Rite of Passage repo on camera and it's instantly mirrored on the other side. The screenshot doesn't do it justic: I'm cloning the repo in `indir` and it's instantly mirrored in `outdir`.
+
+You'll learn
+
+- parallelizing workloads with actors
+- file management
+- spawning processes
+- inter-process communication
+- communicating remotely across the network
+</Fragment>
+
+<Fragment slot="feature6">
+### Project 6: RAGnarok
+
+This is an AI chatbot trained on my own blog on camera. It's able to give you contextualized answers with code examples and references where it found the information.
+
+You'll learn how to build your own AI agent trained on your own data.
 
-### The applications you'll build:
-
-- Photo processor
-    - Java interop
-    - photo manipulation techniques
-    - practical math
-    - custom command line
-- Website scraper
-    - JVM scraping libraries
-    - mapping to your own domain model
-    - data extraction techniques
-    - email newsletters
-- Static site generator
-    - server-side rendering
-    - website packaging
-    - configurations
-    - build pipelines & deployment
-- Full-stack web application
-    - full-stack layered architecture
-    - HTTP APIs
-    - database access
-    - frontend integration
-- File synchronizers
-    - system access
-    - concurrency
-    - process communication
-- AI agents
-    - data ingestion
-    - agent fine-tuning
-    - exposing chat interfaces
+Enough said!
 
 </Fragment>
 </CourseLayout>
diff --git a/src/pages/courses/_layouts/CourseLayout.astro b/src/pages/courses/_layouts/CourseLayout.astro
@@ -282,6 +282,7 @@ const _prerequisitess = await getCollection("prerequisites"),
           <slot name="feature3" slot="feature3" />
           <slot name="feature4" slot="feature4" />
           <slot name="feature5" slot="feature5" />
+          <slot name="feature6" slot="feature6" />
         </Features>
       )
     }
diff --git a/src/pages/courses/_sections/Features.astro b/src/pages/courses/_sections/Features.astro
@@ -47,4 +47,11 @@ const { color, features } = Astro.props;
       </Feature>
     )
   }
+  {
+    features.six && (
+      <Feature image={features.six} imagePosition="left">
+        <slot name="feature6" />
+      </Feature>
+    )
+  }
 </Section>
