Getting Started

Initial Setup

All new sites should use the following process when setting up a new site:

1. Create a new repo on Github 
   1. Set Owner to ed-digital, and name your repo like some-client-name.
   2. Set Repository Template to ed-digital/eddev-starter-theme
   3. Hit Create repository
2. Create a new site in Local, on your computer.
   1. Use the default settings
   2. Be sure to use ed_admin as the username, and generate a secure password using 1Password or similar, and the email address should be web@ed.com.au
   3. Save the username and password to 1Pass.
3. Install the following plugins:
   1. Advanced Custom Fields Pro (download ) (login details in 1Password)
   2. Add the licence key as the key for ACF Pro under ‘Custom Fields > Updates’. The licence key is also in 1Password for convenience.
   3. Slim SEO — install from plugins dashboard
   4. Nested Pages — install from plugins dashboard
4. Under Settings -> General, set Timezone to Sydney (or the appropriate timezone).
5. Make sure that all the installed plugins have been activated.
6. Clone your newly created theme to wp-content/themes/, making sure that the repo name and the theme folder name are identical.
7. Run the following commands inside the theme folder
   1. composer update
   2. yarn
   3. yarn add --dev eddev@latest
   4. yarn setup
8. Activate the theme under Appearance > Themes
9. Run yarn dev
10. Add, Commit and Push all code changes back to Github.

Initial WP Engine Setup

After you’ve followed the steps above, and the site is running correctly locally, you can create a site on WP Engine:

1. Log into WP Engine 
2. Navigate through Add Site → Build a new site → Get Started
3. Ensure ‘ED.’ is selected under the account picker.
4. Select ‘I will own it’
5. Once complete, restart Local, run yarn build once, and do an initial push to the new site, with all files and the database.

Initial Vercel Setup

Once the WP Engine site is up and running, you can create the Vercel project:

1. Log into Vercel 
2. On the ‘Overview’ tab, navigate to Add New… → Project
3. Select our team from the dropdown, and choose the site repo, then hit ‘Import’.
4. Ensure the project name looks nice
5. Add an Environment Variable with Key: SITE_URL, Value: https://{staging-site-url}
6. Hit Deploy