Skip to content
Starter for creating Perch CMS sites at XM Media
PHP JavaScript HTML CSS Hack Vue Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea
cypress
html
sessions
.browserlistrc
.editorconfig
.eslintrc.js
.gitattributes
.gitignore
.gitlab-ci.yml
.nvmrc
.stylelintrc
LICENSE
README.md
babel.config.js
cypress.json
deploy.sh
jest.config.js
karma.config.js
node_setup.sh
package.json
postcss.config.js
tailwind.config.js
vue.config.js
webpack.base.config.js
webpack.config.js
webpack.customize.js
webpack.dev-server.config.js
webpack.test.config.js
yarn.lock

README.md

Perch Website Starter

Used to create new projects using the Perch CMS at XM Media.

Setting Up a New Site

  1. Download a copy of this repo (probably as a ZIP).
  2. Remove or update the LICENSE file.
  3. Download Perch and merge the existing html/perch dir with the downloaded one.
  4. Delete html/perch/.gitignore so the Perch core will be committed to the repo.
  5. Find and make changes near @todo-perch comments throughout the site. Especially important to do the one in .gitignore otherwise the private config may be committed to the repo!
  6. Make dev redirect change in .htaccess (search for @todo)
  7. Run . ./node_setup.sh to configure node & webpack.
  8. Run yarn to install node packages.
  9. Run webpack or webpack --watch to compile JS & CSS files. (When going live, run npm run build instead.)
  10. Run Perch setup at: /perch/setup
  11. Delete the /perch/setup folder.
  12. Set the appropriate permissions on /perch/resources (if needed).
You can’t perform that action at this time.