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