Official Website | Opportunities | Facebook
Working with the latest technologies, designing the best products, and sharing our knowledge with the world wide community.
The OpenForge Community is composed of team members and public contributors banded together for a common goal of leading by example. We are experts in applying UI/UX and Software Architecture principles towards enhancing businesses nation (and world!) wide.
In addition to providing services for our clients; it is our belief that we should also focus on benefiting the community that surrounds us. For this reason; all OpenForge initiatives (that are not client related) are Open Sourced; including our design and business consulting resources which can be found on our Website at www.openforge.io.
If you are a community member who would like to take part of our paid (yes, we said PAID!) Open Source contributions please reach out to us via our opportunities page. We also always encourage anyone to contribute to anything we are doing, and we hope to contribute to your projects as well!
The OpenForge.io website is built using a combination of Stencil.js by our friends at Ionic Framework and Bootstrap for styling.
npm install
https://developers.google.com/speed/webp/docs/precompiled
brew install webp
for file in src/assets/*.jpg; do cwebp -q 75 "$file" -o "${file%.jpg}.webp"; done
for file in src/assets/*.png; do cwebp -q 75 "$file" -o "${file%.png}.webp"; done
for file in src/assets/*.jpeg; do cwebp -q 75 "$file" -o "${file%.jpeg}.webp"; done
By default, the public version of this project does not contain an API key for the ButterCMS blog content management system. You will need to add your own ButterCMS API key in order to make this project work.
The necessary file for inserting the ButterCMS API key will be auto-generated by running
node scripts/get-butter.js
After that, use your text editor and open the file:
src/butter-api/butter-api-key.ts
and enter your Butter API key between the single quotes '':
export const BUTTER_API_KEY = '';
to
export const BUTTER_API_KEY = 'your API token goes here';
npm run dev
npm run dev --es5 // firefox
UI components should reside in the src/components folder.
While Page components should reside in the src/pages folder. A page component is responsible for the grouping and layout of varios different components into a page. Also responsible for any logic around the communication between the different components, the rest of the application (i.e. routing), and with the external world.
This project uses:
- sass-lint for sass linting (sass-lint.yml contains configuration)
- prettier for code formatting.
- tslint for linting with rules from:
package.json defines an npm script for linting. To lint the project at any time, simply run the script with
$ npm run lint
CSS Linting
$ node_modules/sass-lint/bin/sass-lint.js sass-lint -c sass-lint.yml '**/*.scss' -v -q
We utilize Conventional Changelog to generate a changelog from git metadata.
The following tools are used to achieve this purpose:
With the current configuration, after a developer stages their changes for a commit. They can use the following npm script to walk them through committing their changes.
npm run cz
Read more about the commit guidelines here
After all changes have been committed, a release and a changelog can be triggered by using the npm version command. And the current configuration takes care of generating the changelog file based on git metadata.
The project uses husky for git hook integations. And uses lint-staged to run automatically run linters on staged files. And commitlint to ensure commits messages follow the conventions.
For every commit, it will ensure files are linted and that the code is formatted to prettier's configuration. It will also confirm that the proposed commit message matches the defined guidelines. If any error occurs in the process, it will stop and prevent the commit until the issues are fixed.
If a developer went through providing all the information during a npm run cz only to find that there were issues with their commit. They may fix them and instruct commitizen to try the commit again with npm run cz -- --retry
This project uses ButterCMS as a headless content management system. When a user accesses the deployed site, the blog data will be loaded from the ButterCMS API via AJAX. However, the blog data is also utilized in prerendering the site, to improve SEO. Before any build (dev, prod, prerender), the get-butter.js script is run to retrieve the blog data and stored in pages/blog-post/prerender-blog-data.ts. This file is git-ignored so that the repo is not cluttered with blog content.
The project also utilizes webhooks from ButterCMS and Travis to keep the prerendered blog content up to date. Whenever a new blog post is published, Butter's webook invokes the cloud function rebuildMaster, which relays the information to the Travis API, which in turn will trigger a rebuild and redeploy of the master branch. Butter's webhooks are managed in the ButterCMS portal.
The branches develop, qa, staging, and master are all set up for continuous integration and deployment with Travis CI and Firebase. To deploy, create a PR for the appropriate branch, or commit and push directly (avoid this if possible).
If manual deployment is needed, use the following. Only do this on the develop branch, follow the PR request flow for all other branches.
The featured post is managed in the ButterCMS portal. To make a post featured, it must be given a tag of 'featured'. The actual featured post will be the most recently published post with the featured tag. Currently, this post will also appear in the regular list of posts.
This project uses Cypress for front end testing.
It is neccesary to install Cypress for test writing
npm install cypress --save-dev
This will install Cypress locally as a dev dependency
To launch Cypress Test Runner, the next command is needed
npx cypress open
Cypress provides a Dashboard, it is neccesary for the integration.
1.- Go to organization switcher and choose your organization.
2.- Click on the project you wish to integrate
3.- Go to project settings
4.- Click install Cypress Github app
5.- Select repositary you wish to integrate
6.- Done
npm run prepublish
Note that this will synchronously retrieve the blog post data from Butter CMS before building, so that it can be included in the prerender.
Note: You may have to install firebase-tools via npm install -g firebase-tools and then authenticate via command line on your local machine to firebase
npm run firebase:deploy:dev // deploy to firebase dev environment