Documentation
All Release Notes

CLI changelog

4 November 2022
Announcement
CLI

The release notes published before 4 November 2022 are archived below.

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)

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

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

Version 1.20.1 (2022-05-24)

Bug fixes

  • 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)

Bug fixes

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

Version 1.19.1 (2022-05-10)

Bug fixes

  • 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)

Bug fixes

  • fix dependency error which prevented version 1.17.1 from starting

Version 1.17.2 (2022-04-28)

Bug fixes

  • 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)

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

  • only add hostname for the 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 <customer<.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

Bug fixes

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

Version 1.10.1 (2022-01-24)

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

  • 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

Bug fixes

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

Version 1.6.2 (2021-09-06)

Bug fixes

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

Version 1.6.1 (2021-08-24)

Bug fixes

  • 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

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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.

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

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

Version 1.3.1 (2021-06-15)

Bug fixes

  • 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

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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

Bug fixes

  • 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".

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

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

Version 0.20.5 (2021-01-27)

Bug fixes

  • fixes a problem with the homebrew JavaScript dependency path resolution

Version 0.20.4 (2021-01-27)

Bug fixes

  • improvements to the release process

Version 0.20.3 (2021-01-27)

Bug fixes

  • fixes a problem with package generation

Version 0.20.2 (2021-01-26)

Bug fixes

  • fixes a problem with homebrew installation

Version 0.20.1 (2021-01-26)

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

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

Version 0.18.2 (2020-12-04)

Bug fixes

  • fixed problem with using staging servers as remote

Version 0.18.2 (2020-12-02)

Bug fixes

  • 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)

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

  • 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"
  • "frontastic xdebug" command to open a SSH tunnel to the Frontastic Machine for remote XDebug usage

Version 0.16.2 (2020-11-09)

Bug fixes

  • include all external dependencies again

Version 0.16.1 (2020-11-09)

Bug fixes

  • 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

Bug fixes

  • hostsfile entries are now correctly removed

Version 0.15.1 (2020-10-26)

Bug fixes

  • 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)

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

  • 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")

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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

Bug fixes

  • 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

Bug fixes

  • error logging for the SSR process is enabled again

Version 0.8.0 (2020-08-04)

Bug fixes

  • 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)

Bug fixes

  • 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

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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)

Bug fixes

  • 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