Frontastic CLI for Windows

Frontastic CLI is the central entry point for frontend development with Frontastic. It's possible to run webpack, which prepares all frontend code, directly on your machine and everything else in the Cloud.

Unfortunately, support for Frontastic CLI on Windows is still limited but we're working on improving this.

For now, if you're using Windows, you'll need to use a Frontastic Machine for frontend development.

Getting started

You'll have problems if you run Frontastic CLI in the same checkout as a container/VM. You need to do a clean Git checkout of your project. Also, Frontastic CLI requires that there's no container/VM with Frontastic running on your machine when using it.

To get Frontastic CLI running on your Windows system, you'll need to download the package from the Frontastic CLI release page

Then head to the Frontastic Editor and bring up a new machine. For full steps on how to do this, see the Frontastic Machine article.

Basic usage

1
Run  frontastic init in the root directory of your code repository checkout
This will iterate you through some questions for generating the base Frontastic CLI configuration. Be sure to select to synchronize both file types (backend and frontend).

You can repeat this step later when you want to change the configuration. 

2
Create an SSH key with  ssh-keygen -t ed225519 -a 100, make sure to use the default filename (for example,  $HOME/.ssh/id_ed25519). Do  not set a password

3
Copy the public key to the Frontastic Machine and append it to the  ssh-copy-id vagrant@your-machine.frontastic.dev

4
Check that  ssh vagrant@your-machine.frontastic.dev connects without asking for anything

5
Set  checkssh = false in  frontastic.toml

6
Run  .\frontastic.exe filesync

You can now access your development environment under:

http://<project>-<customer>.frontastic.io.local


When you're done for the day, you can stop the development service by hitting <Ctrl>-<C>

Troubleshooting

Yarn has errors on installation

Please make sure you've done a fresh checkout after using a container/VM. Or you can remove all node_modules folders (even those in paas/...) and try again. You can clean up your entire code base to the state of a fresh clone using git clean -f -d -x.

Frontastic CLI claims ports are in use

You might have a Frontastic container/VM running in another directory. Make sure this is shut down properly using vagrant halt in the directory in question. Another reason might be that you have a webserver running locally on port 80 please shut this down before starting the Frontastic CLI.

In rare cases, there might also be a dangling process of a utility used by Frontastic CLI. To check this, see if there are processes running named mutagen or traefik. If so, terminate those and try again. If that does still not help, restarting your computer to release the ports from zombie processes might help.


‹ Back to article list

Next article ›

Bringing up a Frontastic Machine

Still need help? Contact us Contact us