De praktijk achter onze monorepo

Sommige technische keuzes maak je niet omdat het moet, maar omdat je verder wil. Verder dan goed, richting structureel beter. Zo ontstond onze monorepo, het nieuwe fundament van de BOLD Backoffice.

Binnen BOLD Digital delen veel klantapplicaties dezelfde technische basis. Dat is het resultaat van een consistente manier van bouwen die we door de jaren heen hebben ontwikkeld. En juist die consistentie maakte het nu mogelijk om een volgende stap te zetten.

Sybren Dotinga, senior frontend developer en kartrekker van de monorepo, herkende het patroon. "Veel klantapplicaties delen dezelfde technische kern: data ophalen en verwerken op basis van een entiteit. Of het nu gaat om een project bewerken of een order plaatsen."

Die gedeelde basis was sterk genoeg om op te bouwen en dat is dus precies wat we deden met de ontwikkeling van onze monorepo..

Van gezamenlijk inzicht naar gezamenlijke koers

Een monorepo staat of valt bij draagvlak. Daarom is afstemming geen eenmalige stap, maar een continu proces. Vier keer per jaar staat dan ook een guild-week centraal. Vooraf zijn prioriteiten en doelstellingen scherp geformuleerd, zodat iedereen met focus kan werken. Frontend, backend en devops trekken samen op aan concrete verbeteringen.

"Door die combinatie van focus en kennisdeling kunnen we in korte tijd echt meters maken", zegt Sybren. "In Driver-overleggen bepalen we samen de strategische en technische koers van de backoffice. Die beslissingen vertalen we vervolgens samen naar concrete acties. En na elke guild-week reflecteren we op het proces en de resultaten. Wat werkte goed? Wat kan beter? Die feedback nemen we direct mee in de volgende iteratie.”

Waarom een monorepo?

De keuze voor een monorepo was geen reactie op iets dat misliep. Het was een bewuste investering in verdere schaalbaarheid en efficiëntie. Iets dat onze opdrachtgevers van ons mogen verwachten. 

"We zien dat we veel vraagstukken binnen klantprojecten kunnen oplossen vanuit onze backoffice", zegt Sybren. "Met de monorepo bouwen we een solide basis om veelvoorkomende functionaliteiten centraal te ontwikkelen en nog breder in te zetten."

Eén centrale repository dus, waarin applicaties en tooling samenkomen. Het resultaat is minder fragmentatie, meer grip op complexiteit, en een fundament dat meegroeit met onze ambities.

Structuur en tooling

Binnen de monorepo werken we met Nx als basis, een weloverwogen keuze na het vergelijken van alternatieven. Nx biedt inzicht in afhankelijkheden via een dependency graph, slimme caching voor snellere builds en tests, en duidelijke controle over package boundaries.

"De monorepo dwingt je kritisch te kijken naar herbruikbaarheid en dependency management", zegt Sybren. "Duidelijke package boundaries zijn daarbij essentieel."

Uniformiteit borgen we met vaste technische afspraken: TypeScript en ESLint zorgen dat applicaties structureel op elkaar lijken. Tegelijkertijd blijft er ruimte voor context. "We leggen veel vast via codeconventies, maar laten via configuratie ook ruimte om af te wijken waar dat nodig is."

Gedeelde UI, met toegankelijkheid als standaard

Binnen de monorepo speelt de UI-bibliotheek een centrale rol. Niet alleen visueel, maar vooral functioneel. "Voor ons gaat UI verder dan iets aantrekkelijk maken", zegt Sybren. "We willen dat een interactie logisch, intuïtief en voorspelbaar is."

En bij ons is toegankelijkheid geen nagedachte, maar standaard ingebouwd. Van correcte semantiek en toetsenbordnavigatie tot voldoende kleurcontrast: onze componenten zijn WCAG-conform ingericht. Doordat alles centraal wordt beheerd, profiteert elke applicatie direct van verbeteringen.

Wat het ons heeft gebracht

Werken aan de monorepo heeft de kijk op frontend-architectuur binnen BOLD Digital verder aangescherpt. "Goede architectuur draait niet alleen om frameworks of technologie", zegt Sybren. "Het gaat net zo goed om duidelijke afspraken en concrete richtlijnen."

Die keuzes hebben directe impact op samenwerking. Architectuur en samenwerking gaan hand in hand. Hoe beter de structuur, hoe soepeler teams samenwerken, voor elkaar en voor onze klanten.

Bouwen aan een gedeeld fundament

De monorepo groeit mee met BOLD Digital. Dankzij guild-weken en continue feedback blijft het platform zich ontwikkelen. Sneller, consistenter en met meer vertrouwen. Niet omdat het moest, maar omdat we verder willen.

‍