This page describes what you can do once you have downloaded your starter project. You will be able to download your project after selecting modules and having configured them on the Goldstack website. Please see How Does It Work for more details.
The video guides below cover all the steps that are described on this page:
Goldstack requires a few dependencies to be available in your development system. Please verify they are present or install them:
Open a terminal and run:
See the required versions above.
Extract the contents of the zip file into a folder of your choice. After you have done that, you must initialise the project. Simply run the following in your project directory:
The installation process should take around 3-10 minutes depending on the modules you have selected and your Internet speed.
You can confirm everything was installed correctly by running:
Which should show a yarn version of 2.0.0+.
Make sure that everything builds correctly by running the following in your project directory:
Your project should come with all files required to configure VSCode. Configuration files are in the
.vscode/ folder. Simply open the folder of your project in VSCode. If you are asked to allow the installation of additional extensions, please confirm to install them.
If you want to install the necessary extensions manually, here are links to the extensions required:
Try to find any
.ts file in your project. They should be present in one of your modules under
Once you open a
In the status bar on the bottom righthand corner of the VSCode editor you should now see TypeScript along with a version such as 3.9.5-pnpify.
If the confirmation dialog does not show up or the version that you see does not include pnpify, click the version number next to TypeScript. Then select the TypeScript version from the list that includes pnpify.
If you have configured your project for AWS deployment on Goldstack before downloading the project, all modules should be ready to be deployed to AWS. We recommend going through each of your modules individually to ensure the infrastructure for them can be deployed successfully. Please see the getting started guides for the templates you have chosen for instructions. You should have received an email that contains links to the relevant getting started guides.
Each module you have selected comes with its own instructions about how to get started with development. However, there are some handy commands in the project root that can be useful for development:
yarn build: Will build all modules in the project.
yarn compile-watch: Will watch for any changes in your TypeScript files in all modules, and compile them when required. It is essential to have this command running if you develop TypeScript libraries or supporting modules such as S3 or Email Send.
yarn test-watch: Will run tests when modules have changed.
Note that you can run all of these commands in the context of individual modules as well. If you only modify code within one module, this is sufficient. However, if you develop multiple modules at the same time, it is important to run these commands at the project root.