Changelog ​
All notable changes follow Keep a Changelog and Semantic Versioning.
To move your site to a new version, and for the steps each version needs, see Upgrading to a new version in the documentation (upgrading.html).
[1.0.0] - 2026-10-01 ​
First release.
Newsroom ​
- Articles of five kinds: article, video, audio, gallery and live blog. Each has scheduling, flags, sections, tags, series, co-authors, source credit and SEO fields.
- Rich editor:
- images and galleries from the media library;
- video and social embeds, tables, callouts and pull quotes;
- related-article and ad blocks.
- Autosave, edit locking with take-over, and revision history with a side-by-side diff and restore.
- Editorial workflow: submit for review, return to draft, schedule, publish and archive, with notifications and desk notes.
- Translations of articles, linked across languages.
- Live blogs with timestamped, pinnable updates. Readers see new updates without reloading.
- Sections with drag and drop ordering and translations, plus tags and series.
- Pages, and a drag and drop menu builder.
- Reader comments with a moderation queue, bulk actions and staff replies.
- Article search with MySQL full-text search.
- A trash with restore, and bulk actions on the article list.
- Media library:
- uploads with progress, checked by content and stored under random names;
- GPS and camera data removed from photos;
- WebP sizes cropped around a chosen focal point;
- alt text, captions, credits, folders and a picker dialog.
Admin ​
- Light and dark mode, with the Plus Jakarta Sans typeface.
- Search or jump to anything with Ctrl K (⌘ K on a Mac) or "/": screens, things to create, articles by headline, and single settings.
- Keyboard shortcuts: G then a letter goes to a screen, and "?" lists them all.
- Dashboard:
- today's to-do counters, each opening the matching filtered list;
- views for the last 7, 14 or 30 days, compared with the week before;
- the next scheduled story, the most read articles and new members.
- For new sites: "Get your site ready" (each step ticks by itself when it is done) and a short tour of the admin.
- Empty screens explain what they are for and what to do next. Help on 29 screens links into the documentation.
- Roles and permissions: 7 built-in roles, custom roles and a permission matrix. Admins cannot change or delete accounts that rank as high as their own.
- Users, site settings (with a test email) and an activity log of admin changes and sign-ins.
- Statistics: views, most read articles, authors and sections, where readers come from, and on which devices.
Website ​
- Three themes: Classic (a news portal), Magazine and Minimal. Each has dark mode and right-to-left support, and they can be edited without build tools.
- Theme customizer with a live preview.
- Drag and drop layouts for the home page, sidebars and footer:
- blocks in a main column, a sidebar beside it, or across the page;
- sections side by side, galleries, a mosaic of top stories, sliders and numbered lists;
- social tiles with follower counts;
- a header ticker of trending, latest or breaking stories.
- Addresses per language, such as /ar/politics, with hreflang links between translations.
- SEO:
- titles, descriptions, canonical addresses, and Open Graph and X cards;
- structured data for news, live blogs, authors and breadcrumbs;
- XML sitemaps with images, a Google News sitemap and RSS feeds per section;
- an editable robots.txt.
- Redirects manager, with automatic redirects when articles, sections or pages move, and a list of missing pages.
- Author pages, article view counts and "Most read" lists.
- Contact form, draft previews, Google Analytics 4 and Plausible.
AI ​
- Works with your own accounts: OpenAI, Anthropic Claude, Google Gemini, OpenRouter, Ollama and any OpenAI-compatible server. Keys are encrypted, model names are editable, and each provider has a test button.
- Choose a provider for each job: writing, headlines and SEO, summaries, translation, alt text, pictures and speech.
- In the editor: expand, shorten, rewrite in a tone, fix spelling, simplify, continue writing and translate a selection, with answers shown as they are written.
- Assistant panel:
- first drafts from notes, headline ideas and meta descriptions;
- tags and section suggestions;
- "In short" summaries, and text for push alerts and social posts.
- Translate a whole article into a new draft, and make "Listen to this article" audio. Both run in the background.
- AI featured pictures, credited as AI-generated, and alt text suggestions.
- Editable prompts with version history and a reset to the built-in text.
- Monthly token allowances per person, a usage and cost page, an optional content check, and an "AI helped write this" label for readers.
- Text from articles and feeds is fenced in prompts so it cannot instruct the AI.
Imports ​
- News feeds (RSS, Atom and JSON Feed), checked on a schedule. AI rewrites go into drafts, and the source is always credited.
- WordPress importer: posts, pages, authors, sections, tags, pictures, comments, SEO descriptions and old addresses.
- CSV importer with column matching.
- Both importers run in the background and can resume.
Money ​
- Ads: picture, ad network and Google AdSense ads in zones per theme.
- dates, weights, and targeting by device, language and section;
- impression and click counts;
- ads.txt and sponsored-article labels.
- Memberships:
- plans with monthly and yearly prices and free trials;
- payment by Stripe, PayPal, Razorpay or Paystack;
- a metered paywall and ad-free plans;
- invoices, receipts, and an account page for readers.
- Payment webhooks are signature-checked and applied only once. Card details never reach your server.
Reaching readers ​
- Newsletter with double opt-in, campaigns, a daily or weekly digest, one-click unsubscribe and optional Mailchimp sync.
- Push notifications through Firebase, for the app and the website:
- by topic and language;
- scheduled or sent at once;
- automatic alerts for breaking news.
Mobile app ​
- A Flutter app for Android and iOS. It draws the layout from the app builder and has the NewsLoop design built in.
- Articles have pull quotes, galleries, audio, video, live updates, tags, likes, comments and sharing.
- Readers browse sections, search, tags and writers, and saved articles sync across devices.
- Sign-in with email and two-step codes, Google or Apple. Readers can delete their account in the app.
- Settings for theme, text size, notifications and language, and the open-source licences.
- Offline reading and notifications. Links to the site open in the app.
- Maintenance and required-update screens. The app contains no ads SDK and shows no tracking prompt.
- REST API for the app, described in OpenAPI 3.1, with a Postman collection.
- White-label script (
mobile/tool/whitelabel.dart): sets the name, store IDs, icon, splash, Firebase, Google sign-in and the site's layout from onewhitelabel.yaml. - Build templates for Codemagic (both stores, no Mac needed) and GitHub Actions (Android). The steps are in
docs/mobile-app.md.
App builder ​
- A drag and drop builder with 24 components, screens, menu, theme and app settings.
- The phone preview shows your real articles in every language.
- Undo and redo for everything, and autosave.
- Publishing is checked first, and versions can be compared and rolled back. Installed apps pick up a new layout without a store update.
- Six starter layouts: NewsLoop, Classic, Magazine, Video first, Minimal and Local news.
- App icon and splash screen, checked against the app stores' size rules.
- Layouts can be downloaded as a file and opened again.
Languages ​
- Everything readers see comes in English, Arabic, Spanish, French, Hindi and Bengali. That covers the public site, emails to readers, messages and the mobile app. Arabic reads right to left.
- Home page block headings from a theme follow the reader's language.
- Newsletter emails use the language the reader signed up in.
- A site can change any word in
storage/app/lang/xx.json, and updates keep the change (docs/translations.md). - The admin is in English.
Privacy ​
- Readers download everything the site keeps about them from their account page, as one JSON file. Passwords, keys and tokens are left out.
- Readers can delete their account on the website or in the app. A membership is stopped at the payment company first, so a deleted reader is never charged again.
- Cookie consent: Google Analytics waits for consent. Signed-out readers get no cookies.
Installing and updating ​
- A web installer:
- checks the server;
- tests the database connection before saving it, and explains problems in plain words;
- creates your admin account, and can add demo content;
- shows the cron command to add;
- switches itself off afterwards.
- Works when extracted straight into
public_htmlon Apache and LiteSpeed. The site answers at your domain and its own files, such as.env, stay private. If the address still shows/public, the installer stops and explains what to change. php artisan newsloop:installfor installing from the command line.- System page:
- whether the cron job runs, and background work waiting or failed;
- updates without SSH: after you upload a new version, Update the database finishes it;
- backups of the database and uploads (now, daily or weekly), with download and restore.
- Background work runs from the cron job on shared hosting. No queue worker is needed.
- Demo content: a written newsroom in the invented city of Port Aurel, with drawn illustrations and no third-party images. It has 33 articles, a live blog, a series, comments, pages and menus. A demo site also gets a month of statistics, ads, plans, subscribers and the app design.
Performance ​
- Built and measured on a copy with 20,000 articles. The home page builds in 0.4 s and section pages in 0.5 s.
- Pages are ready-made for signed-out readers. After publishing, one request rebuilds each page while other readers get the previous copy. The home page and the new article are rebuilt straight away.
- The app API caches what is the same for every signed-out reader, and its limits can be set in
.env. - A k6 load test is included in
tests/Load/reading.js.
Security ​
- Security headers on every page, and a strict script policy in the admin.
- Two-step sign-in and passkeys.
- Users, roles and the System page ask for the password again after 30 minutes.
- A new password signs out the app and other browsers. Changing the email needs the current password.
- Article HTML is rendered from an allow-list. Embeds are rebuilt from provider IDs.
- Uploads are checked by content. The uploads folder refuses to run scripts, and pictures above 50 megapixels are refused.
- Comment spam protection: a hidden honeypot field, link limits and rate limits.
- Addresses fetched for imports and AI providers are checked against private networks at every redirect.
- Subscribers-only text and audio are cut on the server, never hidden with CSS. The paywall meter is signed and capped per address.
- App sign-in tokens are hashed, one per device, and removed after six months unused.
- Only trusted roles may add custom code, or edit the head and footer code.