Version 2.4.0

## ⚠️ Breaking changes

- S3 variables are now named: S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY, S3_REGION and S3_BUCKET
- Users now have roles. Refer to the `roles` table and assign a role to a user with the `role_id` column in the `users` table.

## Features

- Add Admin Panel to manage users and presentations
- Add user roles: user, admin
- Add `LANGUAGES` setting to configure available languages in the app
- Add hideable presenter attendee count (#183 #155)
- Add Hungarian translation (#161)
- Add Latvian translation (#163)
- Add custom S3 endpoint with `S3_SCHEME`, `S3_HOST`, `S3_PORT` and `S3_PUBLIC_URL`

## Fixes and improvements

- Upgrade JS dependencies
- Upgrade Elixir dependencies, including Phoenix Live View to 1.0.17
- Upgrade to Tailwind 4+
- Refactor view templates to use {} instead of <%= %>
- Fix event name validation to be required
- Docker image is now using Ubuntu instead of Alpine for better dependencies support
- Fix scrollbar not showing in event manager when no presentation file (#164) (@aryel780)
- Fix settings scroll for small screen (#168)
- Fix duplicate key quiz when duplicate (#182)
- Fix email change confirmation (#172)
- Fix italian translation (#179)
- Fix random poll choices (#184)

Author: alxlion

.env.sample

@@ -3,7 +3,7 @@ BASE_URL=http://localhost:4000
 # SECURE_COOKIE=false
 
 DATABASE_URL=postgres://claper:claper@db:5432/claper
-SECRET_KEY_BASE=0LZiQBLw4WvqPlz4cz8RsHJlxNiSqM9B48y4ChyJ5v1oA0L/TPIqRjQNdPZN3iEG # Generate with `mix phx.gen.secret` 
+SECRET_KEY_BASE=0LZiQBLw4WvqPlz4cz8RsHJlxNiSqM9B48y4ChyJ5v1oA0L/TPIqRjQNdPZN3iEG # Generate with `mix phx.gen.secret`
 # ⚠️ Don't use this exact value for SECRET_KEY_BASE or someone would be able to sign a cookie with user_id=1 and log in as the admin!
 
 # Storage configuration
@@ -12,10 +12,19 @@ PRESENTATION_STORAGE=local
 PRESENTATION_STORAGE_DIR=/app/uploads
 #MAX_FILE_SIZE_MB=15
 
-#AWS_ACCESS_KEY_ID=xxx
-#AWS_SECRET_ACCESS_KEY=xxx
-#AWS_REGION=eu-west-3
-#AWS_PRES_BUCKET=xxx
+# The standard AWS environment variables
+#S3_ACCESS_KEY_ID=xxx
+#S3_SECRET_ACCESS_KEY=xxx
+#S3_REGION=eu-west-3
+#S3_BUCKET=xxx
+
+# If you're using an alternative S3-compatible service, port optional
+#S3_SCHEME=https://
+#S3_HOST=www.example.com
+#S3_PORT=443
+
+# If the public S3-compatible URL is different from the one used to write data
+#S3_PUBLIC_URL=https://www.example.com
 
 # Mail configuration
 
@@ -39,6 +48,7 @@ MAIL_FROM_NAME=Claper
 #ALLOW_UNLINK_EXTERNAL_PROVIDER=false
 #LOGOUT_REDIRECT_URL=https://google.com
 #GS_JPG_RESOLUTION=300x300
+#LANGUAGES=en,fr,es,it,nl,de
 
 # OIDC configuration
 
@@ -49,4 +59,4 @@ MAIL_FROM_NAME=Claper
 # OIDC_SCOPES="openid email profile"
 # OIDC_LOGO_URL=""
 # OIDC_PROPERTY_MAPPINGS="roles:custom_attributes.roles,organization:custom_attributes.organization"
-# OIDC_AUTO_REDIRECT_LOGIN=true
+# OIDC_AUTO_REDIRECT_LOGIN=true

.github/workflows/elixir.yml

@@ -42,8 +42,8 @@ jobs:
     - name: Set up Elixir
       uses: erlef/setup-beam@v1
       with:
-        elixir-version: '1.16.2'
-        otp-version: '26'
+        elixir-version: '1.18.4'
+        otp-version: '28'
     - name: Restore dependencies cache
       uses: actions/cache@v3
       with:

.gitignore

@@ -30,16 +30,21 @@ claper-*.tar
 # Ignore digested assets cache.
 /priv/static/cache_manifest.json
 
+# Env files except sample
+.env*
+!.env.sample
+
 # In case you use Node.js/npm, you want to ignore these.
 npm-debug.log
 /assets/node_modules/
 
 priv/static/images/.DS_Store
 priv/static/.DS_Store
-.env
 priv/static/fonts/.DS_Store
 test/e2e/node_modules
 .DS_Store
 priv/static/.well-known/apple-developer-merchantid-domain-association
 priv/static/loaderio-eb3b956a176cdd4f54eb8570ce8bbb06.txt
 .elixir_ls
+
+tailwind.config.js

CHANGELOG.md

@@ -1,3 +1,35 @@
+### v.2.4.0
+
+### ⚠️ Breaking changes 
+
+- S3 variables are now named: S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY, S3_REGION and S3_BUCKET
+- Users now have roles. Refer to the `roles` table and assign a role to a user with the `role_id` column in the `users` table.
+
+### Features
+
+- Add Admin Panel to manage users and presentations
+- Add user roles: user, admin
+- Add `LANGUAGES` setting to configure available languages in the app
+- Add hideable presenter attendee count (#183 #155)
+- Add Hungarian translation (#161)
+- Add Latvian translation (#163)
+- Add custom S3 endpoint with `S3_SCHEME`, `S3_HOST`, `S3_PORT` and `S3_PUBLIC_URL`
+
+### Fixes and improvements
+
+- Upgrade JS dependencies
+- Upgrade Elixir dependencies, including Phoenix Live View to 1.0.17
+- Upgrade to Tailwind 4+
+- Refactor view templates to use {} instead of <%= %>
+- Fix event name validation to be required
+- Docker image is now using Ubuntu instead of Alpine for better dependencies support
+- Fix scrollbar not showing in event manager when no presentation file (#164) (@aryel780)
+- Fix settings scroll for small screen (#168)
+- Fix duplicate key quiz when duplicate (#182)
+- Fix email change confirmation (#172)
+- Fix italian translation (#179)
+- Fix random poll choices (#184)
+
 ### v.2.3.2
 
 ### Fixes and improvements

CLAUDE.md

@@ -0,0 +1,112 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Common Development Commands
+
+### Setup and Dependencies
+```bash
+# Install dependencies
+mix deps.get
+mix setup  # Runs deps.get + ecto.setup
+
+# Setup database
+mix ecto.setup  # Creates DB, runs migrations, seeds
+mix ecto.reset  # Drops DB and runs ecto.setup
+
+# Install frontend dependencies
+cd assets && npm install && cd ..
+```
+
+### Running the Application
+```bash
+# Start Phoenix server
+mix phx.server
+
+# Or inside IEx
+iex -S mix phx.server
+```
+
+### Testing
+```bash
+# Run tests
+mix test
+
+# Run specific test file
+mix test test/path/to/test_file.exs
+
+# Run test with specific line number
+mix test test/path/to/test_file.exs:42
+```
+
+### Code Quality
+```bash
+# Format code
+mix format
+
+# Run Credo for code analysis
+mix credo
+```
+
+### Building Assets
+```bash
+# For production deployment
+mix assets.deploy
+```
+
+## High-Level Architecture
+
+Claper is an interactive presentation platform built with Phoenix Framework and Elixir. It enables real-time audience interaction during presentations through polls, forms, messages, and quizzes.
+
+### Core Components
+
+1. **Phoenix LiveView Architecture**
+   - Real-time updates without JavaScript through WebSocket connections
+   - LiveView modules in `lib/claper_web/live/` handle interactive UI
+   - Presence tracking for real-time user counts
+
+2. **Main Domain Contexts** (in `lib/claper/`)
+   - `Accounts` - User management, authentication, OIDC integration
+   - `Events` - Core presentation/event management
+   - `Posts` - Audience messages and reactions
+   - `Polls` - Interactive polls with real-time voting
+   - `Forms` - Custom forms for audience feedback
+   - `Quizzes` - Quiz functionality with LTI support
+   - `Presentations` - Slide management and state tracking
+   - `Embeds` - External content embedding
+
+3. **Authentication & Authorization**
+   - Multiple auth methods: email/password, OIDC
+   - Role-based access control with admin panel
+   - LTI 1.3 support for educational platforms
+
+4. **Real-time Features**
+   - Phoenix PubSub for broadcasting updates
+   - Phoenix Presence for tracking online users
+   - LiveView for reactive UI without custom JavaScript
+
+5. **Background Jobs**
+   - Oban for background job processing
+   - Email sending
+
+6. **Frontend Stack**
+   - Tailwind CSS for styling (with DaisyUI components)
+   - Alpine.js for minimal JavaScript interactions
+   - esbuild for JavaScript bundling
+   - Separate admin and user interfaces
+
+7. **Key LiveView Modules**
+   - `EventLive.Show` - Attendee view
+   - `EventLive.Presenter` - Presenter control view
+   - `EventLive.Manage` - Event management interface
+   - `AdminLive.*` - Admin panel components
+
+8. **Database Structure**
+   - PostgreSQL with Ecto
+   - Key models: User, Event, Post, Poll, Quiz, PresentationState
+   - Soft deletes for users
+   - UUID-based public identifiers
+
+9. **LTI Integration**
+   - LTI 1.3 support for quizzes, publish score to LMS
+   - LTI launch handling in `LtiController`

CNAME

@@ -1,48 +1,29 @@
-# Find eligible builder and runner images on Docker Hub. We use Ubuntu/Debian instead of
-# Alpine to avoid DNS resolution issues in production.
-#
-# https://hub.docker.com/r/hexpm/elixir/tags?page=1&name=ubuntu
-# https://hub.docker.com/_/ubuntu?tab=tags
-#
-#
-# This file is based on these images:
-#
-#   - https://hub.docker.com/r/hexpm/elixir/tags - for the build image
-#   - https://hub.docker.com/_/debian?tab=tags&page=1&name=bullseye-20210902-slim - for the release image
-#   - https://pkgs.org/ - resource for finding needed packages
-#   - Ex: hexpm/elixir:1.13.2-erlang-24.2.1-debian-bullseye-20210902-slim
-#
-ARG BUILDER_IMAGE="hexpm/elixir:1.16.0-erlang-26.2.1-alpine-3.18.4"
-ARG RUNNER_IMAGE="alpine:3.18.4"
+ARG BUILDER_IMAGE="hexpm/elixir:1.18.4-erlang-28.0.1-ubuntu-noble-20250619"
+ARG RUNNER_IMAGE="ubuntu:24.04"
 
 FROM ${BUILDER_IMAGE} as builder
 
-# install build dependencies
-# RUN apt-get update -y && apt-get install -y curl build-essential git \
-#     && apt-get clean && rm -f /var/lib/apt/lists/*_*
-RUN apk add --no-cache -U build-base git curl bash ca-certificates nodejs npm openssl ncurses
-
-ENV NODE_VERSION 16.20.0
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    git \
+    curl \
+    bash \
+    ca-certificates \
+    nodejs \
+    npm \
+    openssl \
+    libncurses5-dev \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+ENV NODE_VERSION 22.17.0
 ENV PRESENTATION_STORAGE_DIR /app/uploads
 
 # custom ERL_FLAGS are passed for (public) multi-platform builds
 # to fix qemu segfault, more info: https://github.com/erlang/otp/pull/6340
 ARG ERL_FLAGS
 ENV ERL_FLAGS=$ERL_FLAGS
 
-# Install nvm with node and npm
-# RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash \
-#     && . $HOME/.nvm/nvm.sh \
-#     && nvm install $NODE_VERSION \
-#     && nvm alias default $NODE_VERSION \
-#     && nvm use default
-
-# ENV NODE_PATH $HOME/.nvm/versions/node/v$NODE_VERSION/lib/node_modules 
-# ENV PATH      $HOME/.nvm/versions/node/v$NODE_VERSION/bin:$PATH
-
-# RUN ln -sf $HOME/.nvm/versions/node/v$NODE_VERSION/bin/npm /usr/bin/npm
-# RUN ln -sf $HOME/.nvm/versions/node/v$NODE_VERSION/bin/node /usr/bin/node
-
 # prepare build dir
 WORKDIR /app
 
@@ -66,25 +47,14 @@ RUN mix deps.compile
 
 COPY priv priv
 
-# note: if your project uses a tool like https://purgecss.com/,
-# which customizes asset compilation based on what it finds in
-# your Elixir templates, you will need to move the asset compilation
-# step down so that `lib` is available.
 COPY assets assets
 
-# Compile the release
 COPY lib lib
 
 RUN mix compile
 
-RUN npm install -g sass
-RUN cd assets && npm i && \
-    sass --no-source-map --style=compressed css/custom.scss ../priv/static/assets/custom.css
-
-# compile assets
-RUN mix assets.deploy.nosass
+RUN mix assets.deploy
 
-# Changes to config/runtime.exs don't require recompiling the code
 COPY config/runtime.exs config/
 
 COPY rel rel
@@ -94,20 +64,27 @@ RUN mix release
 # the compiled release and other runtime necessities
 FROM ${RUNNER_IMAGE}
 
-# RUN apt-get update -y && apt-get install -y curl libstdc++6 openssl libncurses5 locales ghostscript default-jre libreoffice-java-common \
-#   && apt-get install -y libreoffice --no-install-recommends && apt-get clean && rm -f /var/lib/apt/lists/*_*
-RUN apk add --no-cache curl libstdc++6 openssl ncurses ghostscript openjdk11-jre
+RUN apt-get update -y && apt-get install -y curl libstdc++6 openssl locales ghostscript default-jre libreoffice-java-common \
+  && apt-get install -y libreoffice --no-install-recommends && apt-get clean && rm -f /var/lib/apt/lists/*_*
+# RUN apk add --no-cache curl libstdc++ openssl ncurses ghostscript openjdk11-jre
 
 # Install LibreOffice & Common Fonts
-RUN apk --no-cache add bash libreoffice util-linux libreoffice-common \
-  font-droid-nonlatin font-droid ttf-dejavu ttf-freefont ttf-liberation && \
-  rm -rf /var/cache/apk/*
+RUN apt-get update && apt-get install -y \
+    libreoffice \
+    fonts-dejavu \
+    fonts-freefont-ttf \
+    fonts-liberation \
+    fonts-droid-fallback \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
 
 # Install Microsoft Core Fonts
-RUN apk --no-cache add msttcorefonts-installer fontconfig && \
-  update-ms-fonts && \
-  fc-cache -f && \
-  rm -rf /var/cache/apk/*
+RUN apt-get update && apt-get install -y \
+    ttf-mscorefonts-installer \
+    fontconfig \
+    && fc-cache -f \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
 
 ENV LANG en_US.UTF-8
 ENV LANGUAGE en_US:en

Dockerfile

@@ -61,19 +61,18 @@ RUN ARCH=$(uname -m) && \
     && rm asdf-v${ASDF_VERSION}-linux-${ASDF_ARCH}.tar.gz \
     && mv asdf /usr/bin/
 
-
 # Install Erlang and Elixir using asdf
 RUN asdf plugin add erlang \
     && asdf plugin add elixir \
-    && asdf install erlang 26.2.1 \
-    && asdf install elixir 1.16.0 \
-    && asdf set -u erlang 26.2.1 \
-    && asdf set -u elixir 1.16.0
+    && asdf install erlang 28.0.1 \
+    && asdf install elixir 1.18.4-otp-28 \
+    && asdf set -u erlang 28.0.1 \
+    && asdf set -u elixir 1.18.4-otp-28
 
 # Install Node.js using asdf
 RUN asdf plugin add nodejs \
-    && asdf install nodejs 22.1.0 \
-    && asdf set -u nodejs 22.1.0
+    && asdf install nodejs 22.17.0 \
+    && asdf set -u nodejs 22.17.0
 
 ENV PATH="/root/.asdf/shims:$PATH"
 

Dockerfile.dev

@@ -34,7 +34,7 @@ Claper has a two-sided mission:
 - The first one is to help these people presenting an idea or a message by giving them the opportunity to make their presentation unique and to have real-time feedback from their audience.
 - The second one is to help each participant to take their place, to be an actor in the presentation, in the meeting and to feel important and useful.
 
-Supported languages: 🇬🇧 English, 🇫🇷 French, 🇩🇪 German, 🇪🇸 Spanish, 🇳🇱 Dutch, 🇮🇹 Italian
+Supported languages: 🇬🇧 English, 🇫🇷 French, 🇩🇪 German, 🇪🇸 Spanish, 🇳🇱 Dutch, 🇮🇹 Italian, 🇭🇺 Hungarian, 🇱🇻 Latvian
 
 ### Built With