Hackathon and onboarding set up
If you've booked a hackathon session or you're getting ready for an onboarding session, you'll need to follow the steps below ahead of the session.
If you have any issues during these steps, reply to the email you received from the host of your session.
Apart from the email from your host, you should've also received 2 invitation emails:
- One for GitHub —
<https://github.com/frontastic-developers/><customer>-<name>
- One for our Frontastic studio —
https://<name>.frontastic.io
1. Create a Frontastic sandbox
- Click the link on the email from the Frontastic studio and set up a password
- Log in to the studio
- Click the Developer icon and then Sandboxes
- Click the Add sandbox icon, input a name, and click create
When the status is Running, it's ready to use (this could take up to 10 minutes the first time). In the meantime, you can keep following the steps below.
To find out more about Frontastic sandboxes and how to use them, see the below articles:
- Bringing up a Frontastic sandbox
- More information about Frontastic sandboxes in the Frontastic studio
2. Clone the GitHub repository
- Click the link in the email from GitHub
If you don't have access, reply to the email you received from the host of your session.
- Clone the repository to your local (run
git clone <your-repository>
)
For more information on cloning a repository from GitHub, see their documentation:
3. Set up the Frontastic CLI
For macOS or Linux users:
- Install Homebrew
- Run
brew tap frontasticgmbh/tap && brew install frontastic-cli
- Run
brew install yarn
For Windows users
- Open the Frontastic CLI release page
- Download the latest package
- Extract the zip folder and move theÂ
frontastic.exe
 file andÂfrontastic-cli-dependencies
 folder to the root of your repository (the one you cloned from GitHub) - Install yarn for Windows
For more information, see the articles below:
Sync the Frontastic CLI with the Frontastic sandbox
- Go back to the Frontastic studio and check the sandbox you created in step 1 has a status of
Running
- Copy the hostname of your sandbox (click the copy icon next to the hostname in the Frontastic studio)
- Open a terminal in the root folder of your repository checkout (the one you cloned from GitHub)
- RunÂ
frontastic init --sandbox <paste your sandbox hostname from step 2>
The Frontastic CLI will then ask you some questions, and you'll need to answer as below:
-
Do you want to compile changes to the frontend locally, or should they be synced to the Frontastic sandbox?
SelectÂCopy changes to the Frontastic sandbox where webpack runs
 using the up and down arrow keys and then press enter. -
Do you want to sync backend (PHP) changes to the Frontastic sandbox?
SelectÂCopy backend changes to the Frontastic sandbox
 using the up and down arrow keys and then press enter.
- Run
frontastic run
You might be asked for the password of your sandbox which you can find in the Frontastic studio (click the copy icon in the SSH-Password line then paste into your terminal).
You might also be asked for your local password for sudo (we use this to allow for modification of /etc/hosts
).
Once the run has finished, you should see a dashboard like below:
For more information, see the articles below:
SSH into the sandbox
To SSH into the sandbox, run frontastic ssh
in your terminal.
If the dashboard on your Frontastic CLI has minimal errors (you'll have 1 or 2 ahead of the session), you're now ready for the session!
If you have any issues, reply to the email you received from the host of your session.
Updated about 1 year ago