Install drops-8 with Composer on Pantheon using EC build.
This package is auto-updated.
Last update: 2020-01-27 19:38:26 UTC
New Upstream is a Composer-based Drupal 8 application hosted on Pantheon. Follow this README to create your local environment, and to learn the best practices for effectively contributing to the project.
See the setup documentation if you are installing VirtualBox, Docksal, or Terminus for the first time. Once you meet the requirements, clone the this repository into your Docksal projects directory and initialize the site:
git clone firstname.lastname@example.org:electriccitizen/newupstream.git
Move to your project's root folder and initialize the site:
Once the site is up, you are ready to start working:
- Local: http://newupstream.docksal
- Dev: http://dev-newupstream.pantheonsite.io
- User: admin/admin (local)
You can run fin init any time you want to reset or guarantee that your local environment is in a safe one-to-one state with your upstream environment.
Here are some other helpful
fin commands that you will likely use in your day-to-day work:
fin start to start your project services (or
fin up if you need to re-load configuration for xdebug etc.)
fin stop to stop your project services (recommended)
See (working with Docksal)[docs/local/DOCKSAL.md] for additional Docksal commands and tips.
See troubleshooting Docksal if things go bad.
Here is a safe workflow that will help prevent lost work and other problems.
fin sync (?) to ensure your local site is synced with the upstream environment before starting a new task
git checkout -b <your-feature-branch> to checkout a new feature branch and do your thing
fin drush cex to export your changes
git add to add any new configuration, theme, or custom module files
git commit to commit your changes and get your feature branch into a safe, recoverable state
fin validate (?) to pull in changes from other team members and check your work against the upstream
git push origin <your-feature-branch> to push your feature branch to Github if everything looks good
If you see errors or merge conflicts after running fin sync or fin validate, you will need to work with the team to understand, fix, and commit the conflicting file(s) or other errors before continuing.
Each time you push your feature branch, it triggers a Circle CI build to run tests against the development server. You can continue to push to your branch until your work is complete and your site is passing its automated tests. Once your feature branch looks good and is passing its Circle CI tests, submit a Github pull request against your branch. A project maintainer will review the changes and merge into master.
Note: Advanced or otherwise approved users can submit and merge their own PRs, and/or merge and push a feature branch directly into master without a formal pull request. Ask if you have questions, and err on the side of caution.
You are working in a team environment and must follow a few rules. If you are careless, it can lead to:
- Losing all of your uncommitted work (bad)
- Overriding or losing the work of others (worse)
- Uninstallable configuration or deploy errors
See this guide to following a safe workflow when using configuration management in Drupal 8. The recommended workflow below follows these best practices, and includes two helper commands (
fin sync and
fin validate) that automate important components of a safe work flow.
Upstream ships with a Pattern Lab styleguide baked in. You can deploy the style guide to Github pages by running the
npm run deploy command in the /citizen_patterns folder in the command line. NOTE: You must have the theme installed:
- You may get an error the very first time you run deploy about the /build folder not existing. If you do, simply run it again.
- You get a 404 error at the styleguide url—GH Pages can take anywhere from a few seconds to 10 minutes to deploy (ususally around 15-20 seconds). During deploy you will get a 404 error. Also make sure that you are going to project repo url and the /pattern-lab/public inside there—otherwise you will get 404. If neither are the issue, ask the lead developer.
- Your changes have not appeared after deploy—wait a minute or two and refresh again to make sure that the deploy is finished. Try a hard refresh (Command+Shift+R) to clear the browser cache for the GH Pages url—it often gets stuck, especially in Chrome.
The default github pages url for the site is: https://electriccitizen.github.io/< my-project-repo >/pattern-lab/public. This styleguide url should be customized on site launch to a subdomain of the project url—or some other custom url that disconnects it from the project repo page. Instructions for using a custom domain with gh-pages.
These documents contain other important information about the project and working with your local environment.
- Available commands
- Following a safe workflow
- Frontend and theming documentatiob
- Project notes
- Working with Docksal
If you need support or find any errors or suggested improvements in this README contact email@example.com.
This is an auto-generated document. Keep any custom documents in the