NewsLoopVersion 1.0.0 · offline copyGuides

Customization guide: your logo, colours, theme and app branding ​

This is the guide for the first things most owners do: upload your logo, set your brand colours, and switch or adjust your theme. It puts your publication's brand on NewsLoop: your name, logo, icon and colours, on the website and in the app. You don't need to code or edit any file for the website, or for the app's logo and colours: everything is a setting in the admin panel, and your settings stay when you update NewsLoop or switch themes. Only the app's name, icon and splash screen go into the app file itself, when the app is built for the stores (Step 7).

It takes about 15 minutes. Only the last part, For web developers, involves code, and you can skip it.

In this guide:

  1. Upload your logo and icon
  2. Set your brand colours
  3. Header, fonts and footer
  4. Check your work
  5. Switch your theme
  6. Adjust your theme without code
  7. The app's logo, colour scheme and branding
  8. For web developers: change a theme's design or templates

The Customise screen: colour, header and font settings on the left, a live preview of the home page on the right

What to have ready ​

What What it should be Where it is used
Your logo A PNG or SVG file with a transparent background, wide rather than tall, at least 400 pixels wide. The website's header and Google's search results
A light version of your logo (optional) The same logo in white or a light colour, for dark mode. The header in dark mode
A square icon A square PNG, at least 512 × 512 pixels. Often your logo's symbol or first letter. Browser tabs, bookmarks and phone home screens
An app icon (for the app only) A square PNG, 1024 × 1024 pixels, without transparency. The app on phones
Your brand colour Its six-digit hex code, such as #C8102E. Links, labels, buttons and the news ticker

Finding your brand colour's hex code. Ask your designer, or look in your brand guidelines. If you only have the logo, open it in any free online "colour picker from image" tool, click the main colour, and copy the code that starts with #.

Step 1: your name, logo and icon ​

  1. In the admin, open System → Site settings, then the General tab. (Only Admins can open it.)
  2. Fill in:
    • Site name: your publication's name. Keep it short: names over 14 characters are shown in a smaller size in the header.
    • Tagline: one short line about you. It shows under the name, in the footer and in search results.
  3. Under Logo, upload your logo. Under Logo for dark mode, upload the light version, if you have one. Without it, dark mode shows your normal logo.
  4. Under Site icon, upload the square icon.
  5. Click Save.

Site settings, General: site name, tagline, logo, logo for dark mode and site icon

Your site name is also the sender name and the heading of the emails your site sends, such as newsletters and account emails.

Step 2: your colours ​

  1. Open Site → Customise. Your home page shows on the right, and every change appears there straight away.
  2. Under Colours:
    • Accent colour: paste your brand colour's hex code into the box next to the colour square, or click the square to pick a colour. It is used for links, labels, the news ticker and buttons.
    • Accent colour in dark mode: a lighter shade of the same colour, so it reads well on dark backgrounds. If your brand colour is dark, try the same colour about a third lighter.
    • Light or dark: how your site opens. Readers can still switch with the sun and moon button.
  3. Click Save changes. Nothing goes live before that.

Tip: the accent colour is used for text on white, so very light colours (such as yellow or pale blue) are hard to read. If your brand colour is light, use a darker shade of it here.

Each section can have its own colour, such as red for News and green for Sport. Set it under Organise → Categories, on each section. Section blocks and labels use it. A section without one uses your accent colour.

Still in Site → Customise:

Click Save changes when you're done. Theme defaults puts every setting on this screen back as it was.

Each theme keeps its own Customise settings. If you try another theme and come back, your choices are still there.

Step 4: check your work ​

  1. Open your website in a private browser window, so you see what visitors see.
  2. Look at the header, a section page and an article.
  3. Click the sun and moon button to check dark mode: your light logo and your dark-mode accent colour should show.
  4. Open the site on your phone.
  5. If the browser tab still shows the old icon, it is your browser's memory: it shows the new icon within a day, or after you clear its cache.

Step 5: switch your theme ​

NewsLoop comes with three themes: Classic (a busy news portal), Magazine (a big hero story and large pictures) and Minimal (one column, words first).

  1. Open Site → Themes.
  2. Click Preview and customise under a theme to see your own site in it. Visitors keep seeing your current theme while you look.
  3. Click Use this theme to switch.

Your articles, logo, menus and home page stay as they are. Each theme keeps its own colour and font choices from Step 2 and Step 3, so set them once for the new theme. You can switch back at any time. See Choosing a theme.

The Themes screen with Classic, Magazine and Minimal

Step 6: adjust your theme without code ​

Most changes to a theme need no code:

Step 7: the app's logo, colour scheme and branding ​

The NewsLoop app for Android and iPhone is white-label: readers see your publication's name, icon, logo and colours, never NewsLoop's. This step is the app's own customization guide. Most of it needs no code and no new app release.

What you can change, and where:

What Where you change it When readers see it
Logo in the app's top bar, and its dark-mode version The same logo files as the website, under System → Site settings → General (Step 1). The next time they open the app. No new release.
Colour scheme: main colour, second colour, highlights, background, cards and text, for light and dark mode App → App builder → Theme The next time they open the app. No new release.
Fonts, rounded corners and spacing App → App builder → Theme The next time they open the app. No new release.
App icon on the phone's home screen App → Mobile app After you build the app and release it in the stores
Splash screen: its logo and colour App → Mobile app After you build the app and release it in the stores
App name under the icon app_name in whitelabel.yaml After you build the app and release it in the stores

Change the app's logo and colour scheme (no new release) ​

  1. Upload your logo, and the light version for dark mode, as in Step 1. The app uses the same files as the website.
  2. Open App → App builder and click Theme.
  3. Under App bar, set Logo to Your logo. The other choices show your site's name in text, or in two colours.
  4. Under Light colours, set the Main colour to your brand colour's hex code, such as #C8102E. Then set the Second colour, Highlights, Background, Cards, Text and Quiet text.
  5. Under Dark colours, do the same for dark mode. A dark brand colour can be hard to read on a dark background: a lighter shade of it often works better here.
  6. Choose the fonts, the rounded corners and the spacing if you like.
  7. Check the phone preview in the middle. The toolbar switches it between Android and iPhone, and between light and dark.
  8. Click Publish. Installed apps use your new look the next time they open.

The app builder: components on the left, the phone preview in the middle, settings on the right

To undo a publish, open Versions in the toolbar and publish an earlier version. See App builder.

Change the app's icon, splash screen and name (with a new release) ​

These are part of the app file itself, so a change only reaches readers in a new app release.

  1. On App → Mobile app, upload the app icon: a square PNG, 1024 × 1024 pixels, without transparency. Choose the splash screen logo (a PNG at least 512 pixels wide) and the splash colour.
  2. In the app's folder (Main_File/newsloop-app), open whitelabel.yaml and set your app_name (up to 30 characters), your api_url and your store IDs. Leave icon, splash_color and splash_image empty to use the ones from step 1.
  3. Run the white-label script (dart run tool/whitelabel.dart), then build the app and send it to the stores. The script puts your name, icon and splash screen into the Android and iPhone app.

Step 3 needs a computer with Flutter, or a cloud build service. If someone else builds and publishes your app, give them your whitelabel.yaml. The mobile app: Brand it has every setting, and Build without a Mac has the cloud options.

Check the app's branding ​

Questions ​

For web developers ​

Changing a theme's design ​

For changes the Customise screen doesn't offer, such as other fonts, spacing or a different article layout, make a child theme. It holds only your changes and gets everything else from Classic. Updates then never overwrite your work, while you still get Classic's fixes.

  1. Create the folder themes/my-paper.

  2. Add themes/my-paper/theme.json:

    json
    {
        "name": "My Paper",
        "version": "1.0.0",
        "author": "Your name",
        "description": "Our newspaper's look.",
        "parent": "classic",
        "styles": ["assets/my-paper.css"]
    }
  3. Add themes/my-paper/assets/my-paper.css with your changes. Classic's stylesheet loads first, so you only write the differences. For example:

    css
    /* Headlines in your own font, whichever font pairing is chosen in Customise. */
    @font-face {
        font-family: "Merriweather";
        src: url("merriweather-bold.woff2") format("woff2");
        font-weight: 700;
    }
    :root[data-nf-font-pairing] {
        --nf-font-heading: "Merriweather", Georgia, serif;
    }
    
    /* A thick line in your accent colour under the header. */
    .nf-header { border-bottom: 4px solid var(--nf-accent); }

    Put font files next to the stylesheet in assets/, so they load from your own server. Settings that Customise offers, such as the accent colour, are better changed there.

  4. Choose My Paper under Site → Themes.

To change a template, copy it from themes/classic/views to the same place under themes/my-paper/views, then edit the copy. For example, copy views/article.blade.php to change how articles look. Everything you don't copy still comes from Classic.

Themes are plain Blade templates and CSS: edit a file and upload it, with no build step. Then click Refresh theme files on the Themes screen, so the site copies the new CSS and pictures to where browsers get them. Themes for developers is the full reference: the folder layout, theme.json, layout areas, Customise settings of your own, and what each template receives.

Don't edit the built-in themes

Changes inside themes/classic, themes/magazine or themes/minimal are replaced by the next update. Always use a child theme.