Frontastic CLI changelog

In this changelog, you'll find information about the latest updates to the Frontastic CLI. We add to this list after each release. Big changes will have their own changelog to explain the updates in more detail.

To upgrade to the latest version of the Frontastic CLI run the below command:

brew upgrade frontastic-cli
scoop update frontastic-cli

Version 1.25.0 (2023-01-23)

New Features

  • the URL to the Studio is now shown in the dashboard. It can directly be opened
    by pressing (capital) S

Bugfixes

  • When trying to copy log entries to the clipboard (by pressing c), the CLI
    crashed on Linux systems. This is now fixed.

Version 1.24.0 (2022-09-14)

New Features

  • check for some preconditions before starting (free port 3000 and usage of
    yarn) to avoid some common problem situations

Version 1.23.0 (2022-09-05)

New Features

  • copy entries to clipboard directly from sandbox log view (press c)

Version 1.22.3 (2022-08-25)

Bugfixes

  • fix problem which made it impossible to exit the search view in sandbox log
  • fix crash when pressing G in sandbox log view without any log messages

Version 1.22.2 (2022-08-23)

Bugfixes

  • fix problem where the sandbox log got unresponsive to key presses when
    activating the help window, switching to another page and back to sandbox log
    view

Version 1.22.1 (2022-07-29)

Bugfixes

  • fix display of sandbox log messages if second parameter to console.log is not an object or array

Version 1.22.0 (2022-07-27)

New Features

  • Removed legacy code for multi-tenant sandboxes

Version 1.21.1 (2022-06-22)

Bugfixes

  • fix frontastic install directories when customer does not have yarn workspaces

Version 1.21.0 (2022-06-22)

New Features

  • you can now filter by log level in the sandbox log view (press capital F)

Bugfixes

  • fix a crash when copying a log message to the clipboard by pressing c on macOS
  • fix a crash when navigating the filesync issue view while the issue list was changing

Version 1.20.2 (2022-05-30)

Bugfixes

  • cloudinary cloud name is now provided to the Next.js process through the CLI

Version 1.20.1 (2022-05-24)

Bugfixes

  • fix problem with error count updates on dashboard
  • clearer error highlighting

Version 1.20.0 (2022-05-16)

New Features

  • add ability to insert marker to sandbox log view (press Ctrl-h)
  • print more helpful error message when trying to use run without config
  • show hint about install command when init was finished
  • only output used SSH command if there was a problem
  • much simpler and more reliable json.log processing (for the sandbox log view)

Bugfixes

  • fix problem which resulted in messages of level WARNING not shown in sandbox log

Version 1.19.1 (2022-05-10)

Bugfixes

  • Fix problem which prevented mutagen to start because of a version parsing problem

Version 1.19.0 (2022-05-09)

New Features

  • frontastic-cli is now installable using scoop on Windows

Version 1.18.0 (2022-05-05)

New Features

  • sync bundle.min.js.map to sandbox
  • allow HTTPS connection to local frontend

Version 1.17.3 (2022-04-28)

Bugfixes

  • fix dependency error which prevented version 1.17.1 from starting

Version 1.17.2 (2022-04-28)

Bugfixes

  • rolling back to state of version 1.17.0 because 1.17.1 introduced a bug which
    prevented the CLI from starting (with a "missing dependency" error)

Version 1.17.1 (2022-04-27)

Bugfixes

  • also synchronize project.yml.dev configuration to sandboxes

Version 1.17.0 (2022-04-04)

New Features

  • improved keyboard shortcuts for sandbox log view
  • filter internal API hub messages by default in sandbox view (press a to change that)
  • output URL pointing to the latest version on version check

Version 1.16.0 (2022-03-21)

New Features

  • log viewer for internal messages
  • sync project.yml configuration to sandbox

Bugfixes

  • fixed mutagen output which would break the TUI layout
  • improved output for SSH connection testing
  • do not wait for filesync on startup

Version 1.15.1 (2022-03-10)

Bugfixes

  • fix crash on project init

Version 1.15.0 (2022-03-09)

New Features

  • filter deprecation messages in sandbox log view (can be deactivated with --showDeprecated flag)

Bugfixes

  • better reporting on SSH connection check
  • improve error message when no SSH client was found

Version 1.14.0 (2022-03-09)

New Features

  • show context data after message in sandbox log view
  • add shortcut (-v) to verbose flag

Bugfixes

  • make colors in json log view readable on any color scheme
  • update documentation URLs
  • better error reporting for getting the sanbox log
  • fix scrolling down in sandbox log view when searching
  • fix pull command for new type of sandboxes

Version 1.13.0 (2022-02-28)

New Features

  • new logviewer for the sandbox log with capability to search and view details of entries
  • the --debug flag to show more logging information is now called --verbose

Bugfixes

  • fixed problem with pull command for new sandboxes
  • exclude node_modules from sync in project libraries
  • add project libraries (former starters) to sync config
  • escape string sequences with square brackets so that they are shown correctly in log views

Version 1.12.1 (2022-02-09)

Bugfixes

  • only add hostname for studio to sandbox for internal projects

Version 1.12.0 (2022-02-07)

New Features

  • the replicator pull can now be started with "frontastic pull"
  • the Studio of the current sandbox is now accessible through
    .frontastic.io.local in Next.js projects

Version 1.11.0 (2022-02-02)

New Features

  • automatic setup through "frontastic init" on internal demo project (Nextjs)
  • more filesyncs for internal demo project

Bugfixes

  • fixed a freeze when webpack or next.js processes output an error message

Version 1.10.1 (2022-01-24)

Bugfixes

  • removed the API Hub sandbox logview as all messages are not logged to the
    general sandbox log (Nextjs projects)

Version 1.10.0 (2021-11-23)

New Features

  • Support for working with Nextjs projects against a staging server

Version 1.9.0 (2021-11-10)

New Features

  • errors in the frontend and backend logs are now highlighted
  • when the CLI exits with an error, the error is now colored for better discoverability
  • error conditions which may be fixed by using --defaultMutagenDataDir have now a note about the flag
  • when setting up the CLI with a sandbox, it is now clearer when to input the SSH password and where to find it
  • API hub logs (for Nextjs projects) are now parsed and displayed more readable

Bugfixes

  • error counts in the dashboard now better reflect real errors output by webpack and nextjs
  • the error message in the case no SSH keys are available now suggests how to fix that
  • fix shown hotkey for the "general sandbox errors" view (Nextjs projects)
  • the "_shared" directory in multi-project Nextjs repositories is not considered a project anymore
  • remove duplicate xdebug command in help output

Version 1.8.0 (2021-10-19)

New Features

  • ability to insert marker lines into log views (by pressing Ctrl-M)
  • sandbox logs for NextJs projects are now viewable directly in the CLI along
    with logs from the local processes

Version 1.7.2 (2021-10-06)

Bugfixes

  • don't crash when ending filesync pause in react projects
  • (internal projects) don't let mutagen delete composer.phar on ant prepare

Version 1.7.1 (2021-10-04)

New Features

  • package.json and yarn.lock on the repository root are now also synced to the sandbox

Version 1.7.0 (2021-09-13)

New Features

  • New command debug-backend to make calls to the backend and examine their results

Bugfixes

  • Exclude vendor directory in api-hub from sync to sandbox

Version 1.6.2 (2021-09-06)

Bugfixes

  • Flags --defaultMutagenDataDir and --mutagenConfig are now also available for NextJs projects

Version 1.6.1 (2021-08-24)

Bugfixes

  • Fixed "unknown command" error when trying to execute the run command with an existing configuration

Version 1.6.0 (2021-08-23)

New Features

  • Support for Frontastic NextJs projects
  • Support for single server SSR

Bugfixes

  • Fixed problem with special characters in directory names which could have led to illegal filesync configs

Version 1.5.1 (2021-08-09)

New Features

  • CLI will check if npm was used instead of yarn and notice the user

Bugfixes

  • Fix problem where the URL with hostname was not correctly passed to the
    server-side rendering process when running webpack locally which lead to
    problems when trying to access the URL in the server-side rendering (through
    window.location)

Version 1.5.0 (2021-07-27)

New Features

  • When using the filesync pause feature (see 1.4.0), files created on the
    sandbox are now automatically detected and added to the list of files to copy

Version 1.4.4 (2021-07-26)

Bugfixes

  • Fixed a problem where only one cookie was set, even if the request had
    multiple cookies
  • The CLI will no longer report an older version as newer than the installed one
    right after a release

Version 1.4.3 (2021-07-08)

Bugfixes

  • Increased a timeout which prevented the CLI from starting with "Mutagen
    command was not finished" error message on specific machines

Version 1.4.2 (2021-07-07)

Bugfixes

  • Fixed high CPU load caused by a bug introduced in version 1.4.0
  • Documentation and test files from vendor packages are now also synchronized to
    the local machine which avoids filesync errors "Unknown content encountered on
    disk"
  • Filesync issue view now also works when using a custom mutagen configuration
  • Mutagen binaries are automatically updated if the project has an outdated
    version, which avoids "client/daemon version mismatch" errors.

Version 1.4.1 (2021-06-30)

New Features

  • Local static assets in public/assets are now being served instead of the ones
    from the remote server. If a local asset is not available, the one from the
    remote server will be served. This makes it possible to locally work with new
    or modified static assets without requiring filesync to the remote server.

Bugfixes

  • Remote static assets are now served correctly through the CLI

Version 1.4.0 (2021-06-29)

New Features

  • Synchronizing files with the remote server can now be paused by pressing "p"
    to create files on the remote which would otherwise be overridden. The created
    files can be copied to the local machine before resuming the synchronization.
  • A new colorscheme for certain elements
  • Current page is highlighted in the footer, the footer is separated into one
    line with all pages and one line with context-sensitive other commands
  • The footer breaks into more than two lines if horizontal space is not sufficient

Bugfixes

  • Text in log outputs was hard to read in certain terminal colorschems, this is fixed
  • Static assets from the remote server are no longer broken when loaded through the CLI

Version 1.3.2 (2021-06-17)

Bugfixes

  • Closing of the SSR warning box when a SSR error is encountered is now possible
    again

Version 1.3.1 (2021-06-15)

Bugfixes

  • Running the SSR server on another port than 8001 now also works with the CLI
    (it reads the port from project.yml, field ssrPort and defaults to 8001)

Version 1.3.0 (2021-06-08)

New Features

  • Errors in the server side rendering (SSR) are now shown in an overlay box on
    the webpage when running webpack on the local computer
  • When requesting adminstrator/sudo rights, you will get information why they
    are required
  • You can use "frontastic ssh" to get a SSH connection to the current sandbox

Bugfixes

  • The \debug() command for API hub code (PHP) now can output information to the
    browser console when using Frontastic CLI
  • Additional attributes in the appData div are not stripped anymore

Version 1.2.2 (2021-05-25)

New Features

  • Remote server hostname is shown in dashboard

Bugfixes

  • Fixes error making the terminal on Windows unresponsive when quitting the CLI
    under certain circumstances
  • Selection in filesync issue list is now always highlighted, not only when
    non-bold rows are selected
  • Colors in filesync issue list are improved to fix unreadable text with certain
    color themes
  • environment.local file is not deleted in sanbox anymore for (internal)
    replicator development
  • Filesync status on dashboard is now also shown when webpack is also running

Version 1.2.1 (2021-05-18)

Bugfixes

  • Fixed critical bug introduced in 1.2.0 which lets the CLI crash under certain
    circumstances

Version 1.2.0 (2021-05-17)

New features

  • Filesync issues are now shown on the dashboard in the right upper area
  • There is a new filesync issue detail view reachable by pressing "f" which
    lists all filesync issues and offers help resolving them

Version 1.1.0 (2021-05-11)

New features

  • An alternative mutagen (filesync) configuration can be specified with
    --mutagenConfig (e.g. frontastic run --mutagenConfig ./my-mutagen.yml)
  • Using a custom mutagen (filesync) data directory for every project can be
    disabled with --defaultMutagenDataDir (e.g. frontastic run
    --defaultMutagenDataDir). This might help when filesync is not working with
    the message "unable to connect to daemon: connection timed out (is the daemon
    running?)"

Version 1.0.1 (2021-05-10)

Bugfixes

  • Fixed build problem where mutagen binary was not included in Apple Silicon
    release

Version 1.0.0 (2021-05-10)

New features

  • Complete new user interface for better overview
  • Native M1 Apple Silicon support

Bugfixes

  • Fixed Problem which occured when switching from Frontastic Sandbox to Staging
    server
  • New Mutagen (filesync) version with many filesync related fixes
  • Fix in filesync configuration for synchronization of payment provider code

Version 0.21.0 (2021-03-15)

New features

  • There is no separate "frontastic filesync" command anymore. Only use
    "frontastic run".

Bugfixes

  • Fixed many problems with process left running when the CLI terminated

Knwon problems

  • When stopping the CLI on Windows through Taskmanager, the child processes are
    still left running. Use Ctrl-C to avoid that.

Version 0.20.9 (2021-02-25)

  • checks for suitable SSH installation
  • support automatic copying of SSH key to Frontastic Machine on MS Windows
  • fix problem where the CLI crashes when a SSH key is protected by passphrase
    and locked

Version 0.20.8 (2021-02-11)

Bugfixes

  • fixes an issue where the CLI can require a password on top of the key
    authentication
  • fixed an issue where the webpack bundle can be loaded twice if remote is not
    in staging

Version 0.20.7 (2021-02-10)

Bugfixes

  • fixes an issue where errors are trying to log to a file that doesn't exist,
    reducing console spam

Version 0.20.6 (2021-02-09)

Bugfixes

  • fixes issues with SSR Windows compatibility allowing Windows users to run
    webpack locally

Version 0.20.5 (2021-01-27)

Bugfixes

  • fixes a problem with the homebrew JavaScript dependency path resolution

Version 0.20.4 (2021-01-27)

Bugfixes

  • improvements to the release process

Version 0.20.3 (2021-01-27)

Bugfixes

  • fixes a problem with package generation

Version 0.20.2 (2021-01-26)

Bugfixes

  • fixes a problem with homebrew installation

Version 0.20.1 (2021-01-26)

Bugfixes

  • generate tastic command now modifies tastics.js file

Version 0.20.0 (2021-01-26)

New features

  • addition of generate tastic command

Version 0.19.0 (2021-01-25)

New features

  • filesync will now also synchronize a frontend project when working on
    backstage

Bugfixes

  • all relevant files are now synced to the Frontastic Machine
  • hostsfile is automatically cleaned when stopping filesync
  • updated port for "frontastic xdebug" command

Version 0.18.3 (2021-01-12)

Bugfixes

  • fixes a problem with an infinitive sync loop for non as-a-library projects

Version 0.18.2 (2020-12-04)

Bugfixes

  • fixed problem with using staging servers as remote

Version 0.18.2 (2020-12-02)

Bugfixes

  • improve SSH error condition checking and correcting
  • check for existence of mutagen lock and offer to remove
  • improve configuration of remote server hostname

Version 0.18.1 (2020-11-27)

Bugfixes

  • try to ping host five time (instead of once)
  • make ssh hostsfile-update more reliable

Version 0.18.0 (2020-11-26)

New features

  • output used mutagen commands in debug mode
  • make backstage selectable as project for frontastic internal

Bugfixes

  • fix windows build
  • output error if SSR fails and return unmodified page from server
  • simplify config and fix handling of customer hostnames
  • give better error message if wrong project directory was entered
  • stop execution if there was a problem starting traefik
  • avoid mangled mutagen.yml configuration
  • restructure run command to cleanly shut down everything on errors

Version 0.17.1 (2020-11-17)

Bugfixes

  • fix a problem with the "frontastic filesync" command exiting with error
    "unknown command "frontastic""

Version 0.17.0 (2020-11-17)

New features

  • start everything using just the "frontastic run" command, no more "sudo
    frontastic start" or "... stop"
  • "frontastic xdebug" command to open a SSH tunnel to the Frontastic Machine for
    remote XDebug usage

Version 0.16.2 (2020-11-09)

Bugfixes

  • include all external dependencies again

Version 0.16.1 (2020-11-09)

Bugfixes

  • image scaling in SSR is now correct when using Frontastic CLI

Version 0.16.0 (2020-11-04)

New features

  • complete revised filesync integration
  • hostsfile entries are now also added when only using filesync, making it
    possible to access the Frontastic Machine through .local URLs

Bugfixes

  • hostsfile entries are now correctly removed

Version 0.15.1 (2020-10-26)

Bugfixes

  • remove always failing ping test on Windows

Version 0.15.0 (2020-10-21)

New features

  • nearly automatic configuration with "frontastic init"

Version 0.14.1 (2020-10-20)

Bugfixes

  • fixed wrong directories getting synced
  • fixed problem preventing backstage filesync

Version 0.14.0 (2020-10-19)

New features

  • check SSH connection to Frontastic Machine when using filesync and fix
    possible problems

Version 0.13.1 (2020-10-19)

New features

  • "frontastic filesync status" to get the status of the filesync and possible
    problems

Bugfixes

  • fixed error message about dependencies on winodws which prevented Frontastic
    CLI to start

Version 0.13.0 (2020-10-05)

New features

  • now installable and updateable over homebrew (brew install
    frontasticgmbh/tap/frontastic-cli)

Version 0.12.1 (2020-10-05)

Bugfixes

  • fixed problem with wrong dependencies included in release archive ("could not
    rename..." and "no such file or directory" errors on first start)

Version 0.12.0 (2020-09-29)

New features

  • customerName and projectName replace yarnDir configuration
  • syncing changes in paas is now determined from .vm.yml config
  • required ports are checked on startup
  • syncing backstage is now possible (set customerName to "demo" and projectName
    to "backstage")

Bugfixes

  • many improvements and fixes in file sync

Version 0.11.0 (2020-09-21)

New features

  • Frontastic CLI can now synchronize project files with Frontastic Machine
    remote servers

Version 0.10.1 (2020-09-07)

Bugfixes

  • Fixed injecting of bundle.js script tag. Before it was injected in the middle
    of another tag, breaking it in the progress.

Version 0.10.0 (2020-08-25)

New features

  • the tool is renamed to "Frontastic CLI", the binary is called "frontastic" and
    the config "frontastic.toml". Old configs can be renamed automatically.
  • Frontastic CLI will now check for a new version on start and offer to update

Version 0.9.2 (2020-08-20)

Bugfixes

  • fixed a bug where frontasticli would refuse to create a config if there is no
    .frontasticli directory already

Version 0.9.1 (2020-08-11)

New features

  • debug output can be enabled with --debug flag

Bugfixes

  • disable debug output which was enabled by default

Version 0.9.0 (2020-08-11)

New features

  • when there is no configuration file found, an interactive process for
    generating one is started (can also be manually triggered with ./frontasticli init)
  • source maps for the webpack generated css/js assets are available in the
    browser

Bugfixes

  • error logging for the SSR process is enabled again

Version 0.8.0 (2020-08-04)

Bugfixes

  • all generated files are now placed into the directory .frontasticli
  • generated files are no longer owned by root

Version 0.7.1 (2020-07-27)

Bugfixes

  • frontasticli run will now report if the yarndir or traefik config dir does
    not exist and output an error message
  • the session cookie will no longer be discarded by the browser when using a
    staging system as remote, this fixes the problem that items in the cart
    disappear on reload

Version 0.7.0 (2020-07-07)

New features

  • frontasticli config list will show all configuration variables with their
    current value

Bugfixes

  • no crash if SSR is not working properly

Version 0.6.0 (2020-06-24)

New features

  • support staging instances as remote server (which run in production mode)

Bugfixes

  • make new features play nice with staging instances

Version 0.5.0 (2020-06-15)

New features

  • server-side rendering (SSR) will now be done on the local machine and injected
    into the HTML, so that it can be properly tested

Version 0.4.1 (2020-05-01)

Bugfixes

  • fix problem closing the fixture file too early (results in incomplete fixture
    file & error message)

Version 0.4.0 (2020-04-28)

New features

  • support locally running remote server (in docker or virutalbox)

Bugfixes

  • fix problem with passing the host header to the remote server

Version 0.3.0 (2020-04-22)

New features

  • support remote servers running in the new frontastic demo infrastructure
  • support TLS connections to remote servers

Version 0.2.0 (2020-04-01)

New features

  • retrieve fixtures from remote server to import locally with export-fixtures
    command

Version 0.1.0 (2020-03-31)

New features

  • check if yarn is installed
  • output right URL for accessing the catwalk

Version 0.0.1 (2020-03-25)

first versioned release

New features

  • output version on invocation
  • validate that at least one hostname is set and the remote server address is an
    IP