Branding

Change the name, colours, fonts, logo and photos so the academy looks like yours.

Name, tagline and contacts

Dashboard > Settings: the name and tagline in both languages appear in the header, the footer, page titles, the certificate and the dashboard. The "About" text is shown on the About page.

Colours

All colours are tokens at the top of src/app/globals.css. Components never use raw colour values, so changing a token changes the whole site:

Token Default Used for
--color-paper #f4f5f8 page background
--color-ink #191c3a text, primary buttons, the dashboard sidebar
--color-marker #f6cb45 the highlighter: key words in headings, progress bars, focus rings
--color-pen #b8382b errors, wrong answers, destructive buttons
--color-leaf #1f7a5a completed lessons, passed quizzes, success
--color-muted, --color-line, --color-mist secondary text, borders, quiet surfaces
--color-cat-* six hues category spines on course cards and chips
--color-chart-1, --color-chart-2 blue, amber the two dashboard chart series

Keep body text at 4.5:1 contrast or more against --color-paper.

The highlighter

The academy's signature is the marker stroke behind important words. In translations, wrap words in asterisks to highlight them: "title": "Learn a skill that *opens a door* this month". The .hl class in globals.css draws it; change its background-size or colour there.

Fonts

Fonts are loaded in src/app/[locale]/layout.tsx with next/font (self-hosted, no request to Google at run time):

  • Tajawal for body text, Arabic and Latin.
  • El Messiri for Arabic headings and Fraunces for Latin headings (--font-display).

To change one, import another font from next/font/google, give it the same CSS variable, and keep the Arabic and Latin faces close in weight and height.

The mark is an SVG in src/components/site/Logo.tsx (an open book over a marker stroke) and the browser icon is public/icon.svg. Replace both with your own SVG. Logos are never mirrored in Arabic.

Photos

Folder What Size
public/images/courses/ course covers 16:10, about 1500 px wide
public/images/instructors/ portraits 4:5
public/images/blog/ article covers 16:9
public/images/site/ home hero and About photo wide

Courses, instructors and articles can also get images uploaded from the dashboard. The sample photos were generated for this template (see assets/image-prompts.json); the instructors in them are fictional people. npm run images regenerates any missing photo with our image service.

Category colours

Each category has a hue (Dashboard > Categories). Pick one of the six built-in hues or type a #hex colour; it colours the spine of the category's course cards, the chips and the overview chart.