REV. 5.0 — Masonite 5 is here Read the changelog
MasoniteFRAMEWORK
GitHub Get started
Docs Features Changelog GitHub Get started
SHEET 05 masonite.dev

Changelog

Releases, migrations and project news.

In memoriam

In memory of Joseph “Joe” Mancuso

Masonite was created by Joseph “Joe” Mancuso, who passed away in November 2025. Joe built Masonite from the ground up and gave years of work, care and enthusiasm to the framework and its community — everything here exists because of him. The project now continues in his memory, carrying forward the developer-first spirit he gave it. Thank you for everything, Joe.

NEWS Project

Masonite has a new home

Following Joe's passing, the community has taken stewardship of the framework and moved active development to the new masonitedev organization on GitHub. The repository now lives at github.com/masonitedev/masonite and the docs at docs.masonite.dev. The PyPI package was renamed from masonite to masonite-framework.

The original repository and the old masonite package (4.x and earlier) are now deprecated and will no longer receive updates or security fixes — all future development happens under masonitedev.

UPDATE YOUR GIT REMOTE

BASH
$ git remote set-url origin https://github.com/masonitedev/masonite.git
REV. 5.1 Release

Masonite 5.1 latest 5.1.0

  • New masonite new wizardAn interactive, Laravel-style project wizard with arrow-key menus — pick a stack (full-stack or API), a frontend preset and a database, and it creates the virtual environment, installs the dependencies, generates the APP_KEY, initializes git and offers to start the dev server. Every step is also a flag (masonite new blog --api --db=postgres --no-input), and project start keeps working as an alias.
  • Bundled starter skeletonThe starter project now ships inside the package, so creating a project is instant, works offline and no longer depends on the cookie-cutter GitHub repository. --repo, --branch and --release still download custom templates.
  • New welcome pageA welcome page following the Great Pyramid brand — light/dark via prefers-color-scheme, self-contained CSS — plus matching 403/404/500 and maintenance pages.
  • New masonite console scriptAvailable alongside project.

CREATE A PROJECT

BASH
$ pip install masonite-framework
$ masonite new blog
REV. 5.0 Release

Masonite 5.0

  • New home & packageMoved to the masonitedev GitHub org; install with pip install masonite-framework.
  • New logging systemA full logging stack with terminal, single, daily, stack, syslog and slack drivers, configured in config/logging.py and exposed via the Log facade. Unhandled exceptions are now logged automatically with their full traceback.
  • Updated runtimePython 3.10–3.13 is now required (3.8 and 3.9 were dropped at end-of-life).
  • Updated core dependenciesMasonite ORM 3.x and Pendulum 3.x are now required. The ORM is published as masonite-framework-orm (replacing masonite-orm); imports are unchanged (from masoniteorm...).
GUIDE Migration

Upgrading from 4.x to 5.x

  1. Swap the package:
    BASH
    $ pip uninstall masonite
$ pip install "masonite-framework>=5,<6"
  2. Imports are unchanged — keep using import masonite / from masonite import ...; the project and craft commands work the same way.
  3. Make sure you're on Python 3.10–3.13.
  4. Pendulum 3 parses dates more strictly — review your date parsing. In tests, replace pendulum.set_test_now() with pendulum.travel_to() or the built-in self.fakeTime() helper.
  5. Update your git remote (see command above).

Need the full picture? Read the full upgrade guide →