Published by Oscar Öhrn Pagerup
Introduction
OMSPANSKA is a free Swedish-language resource for learning Spanish grammar, designed for secondary school students in Sweden. It combines a clean, structured grammar reference — covering everything from basic nouns and verbs to the subjunctive mood — with interactive drills for practising verb conjugations and vocabulary.
Objective
Spanish is one of the most commonly studied foreign languages in Swedish schools, yet most freely available grammar resources are written in English — adding an extra layer of difficulty for students who are still building their language foundations. The goal of OMSPANSKA was to create a structured, pedagogically sound reference written entirely in Swedish, paired with interactive tools that make it possible to practise what you have read without leaving the site.
The target audience is secondary school students at the beginner and intermediate level, so clarity and approachability were prioritised throughout — both in the writing and in the design.
Tools
- Docusaurus 3.7.0 — static site framework with MDX support for mixing React components into documentation pages
- React 18 — all interactive components (verb drills, vocabulary drills) are built as client-side React components
- JavaScript / JSX — no TypeScript; kept deliberately simple
- CSS Modules — scoped styling for interactive components
- Custom CSS — global editorial design system with CSS variables
- GSAP — animations on the landing page
- npm / webpack — package management and bundling
Challenges
The biggest technical hurdle was a breaking change in webpack 5.106.0 that silently broke the Docusaurus build process. Resolving it required locking the webpack version across three separate fields in package.json to prevent npm from pulling in the incompatible release.
Building rich interactive components — particularly the verb conjugation driller with its 80+ verbs across 18 grammatical categories, and the vocabulary tool with 750 words across 15 difficulty-graded decks — inside a static site framework required careful architecture to keep the data manageable and the user experience smooth.
On the content side, the main challenge was pedagogical rather than technical: writing grammar explanations that are accurate enough to be trustworthy, but simple enough to be genuinely useful to a 15-year-old encountering advanced grammatical concepts for the first time.
Written by Oscar Öhrn Pagerup
← Back to showcase
