Lotta

Lotta is a simple-to use platform aimed at schools. Its comprehensible interface makes it easy for students and teachers to create a sophisticated webpage for their school, providing articles, files and media in access-controlled spaces.

See https://lotta.schule for more information.

The latest git tag is the currently deployed version that also runs unmodified on our infrastructure.

Components

Webapp

Location: packages/webapp

The Webapp is a NextJS app that serves the application. Its primary purpose is serving the frontend.

Hubert

Location: packages/hubert

Hubert is our component library. See our storybook to get an overview over the available components.

Theme

Location: packages/theme

Here lie the definition and schema lotta uses for theming.

Storybook Hubert

Location: packages/storybook-hubert

The storybook project for hubert.

Storybook-Addon-Theme

Location: packages/storybook-addon-theme

A storybook-addon which allows editing the theme in storybook

Development

For monorepo managing, we use nx.

Prerequisites

• Have nodejs installed (See .tool-versions) to see which one
• This is a monorepo taking advantage of pnpm workspaces. You will have to have pnpm installed on your machine.
• Have a working core instance running.

Commands

1. Install the necessary dependencies. In the project's root folder, run:

pnpm install

2. Run all available tests (this will take a few minutes, depending on the machine you run it on):

pnpm test -- --no-watch

3. Run all available linters / typecheckers:

pnpm lint
pnpm typecheck

4. Start the Development environment:

pnpm dev

This will start:

• The Hubert Storybook on localhost:6006. This project lists, shows and documents any components we have available in our component library Hubert.
• The Lotta Webapp. The main web frontend to a lotta project. This is what is usually referred to by lotta. By default, it'll start on localhost:3000 on your machine.

The easiest is to start by creating a new lotta tenant, or copying over the data from some prod or test system. As lotta recognizes its tenants via the host url, we suggest you use http://<tenant-slug>.local.lotta.schule:3000; It's pointed directly to your localhost, but with the extra of having a multitenant-capable hostname