Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brianlusina/brianlusina.github.io
Just some website 🙂
https://github.com/brianlusina/brianlusina.github.io
hacktoberfest react reactjs sass website
Last synced: 3 months ago
JSON representation
Just some website 🙂
- Host: GitHub
- URL: https://github.com/brianlusina/brianlusina.github.io
- Owner: BrianLusina
- License: mit
- Created: 2017-06-18T17:33:54.000Z (over 7 years ago)
- Default Branch: develop
- Last Pushed: 2024-04-15T07:27:59.000Z (9 months ago)
- Last Synced: 2024-04-16T04:58:10.071Z (9 months ago)
- Topics: hacktoberfest, react, reactjs, sass, website
- Language: JavaScript
- Homepage: https://brianlusina.com
- Size: 30.5 MB
- Stars: 6
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Fenestra
[](http://commitizen.github.io/cz-cli/)
[](https://github.com/semantic-release/semantic-release)
[](https://github.com/BrianLusina/brianlusina.github.io/actions/workflows/tests.yml)
[](https://codecov.io/gh/BrianLusina/brianlusina.github.io)
[](https://github.com/BrianLusina/brianlusina.github.io/actions/workflows/lint.yml)
[](https://github.com/BrianLusina/brianlusina.github.io/actions/workflows/build_app.yml)
Personal site built with [ReactJS](https://reactjs.org/).
**Why document and open source my site?**
Part of the belief that OSS is the future and also fosters a community of developers, on top of which not only allows growth, but learnings. And with any OSS, it is important that a document is created to allow contributors to jump on board easily.
## Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Clone the repository:
```bash
# if using ssh
git clone [email protected]:BrianLusina/brianlusina.github.io.git
# or if using https
git clone https://github.com/BrianLusina/brianlusina.github.io.git
```
## Prerequisites
A couple of things you will need to install in order to run this project:
1. [Node and NPM](https://nodejs.org/en/)
Node is a JavaScript Runtime Environment. Installation instructions can be found in the link provided. By installing Node, you will also be installing npm. Node version used is **10.x**
2. [Yarn](https://yarnpkg.com) - (Optional)
Yarn is an alternative package manager to npm. It is not necessary to use, but, if you prefer using yarn, then follow the instructions set out in the download section of the link provided. It is advised, that one package manager is picked due to how differently the dependency graph is managed by both.
## Installing
Installing dependencies is straight forward:
```bash
npm install
# or
yarn install
```
This should set you up to install the dependencies as needed and get you running.
## Running tests
Tests have been written with [Jest](https://facebook.github.io/jest/). Running the tests can be done as follows:
```bash
yarn test
# or
npm run test
```
To generate a coverate report:
```bash
yarn test:coverage
# or
npm run test:coverage
```
## Deployment
Deployment has been configured to work on any system or static server as necessary. Therefore deployment can be to either a microservice application with this running in its own container, or to a static site or to even github pages.
The pipeline set here is to deploy this to a seperate static server when in development in order to do testing and to [github pages](https://pages.github.com/) when finally moving to production. Ideally,this being a blog site which primarily serves static content, that should not matter where it is deployed, as long as it is accessible and can handle incoming traffic.
Tools used for deployment:
- [Docker](https://www.docker.com/)
There is a [Dockerfile](./Dockerfile) available at the root of the project. Which entails instructions on how to deploy this to a system/server that supports running dockerized applications.
- [Surge](https://surge.sh)
Surge is a static hosting site and is used when deploying in development. In order to use this, ensure that you have an account with surge and have the necessary credentials in order to deployto a static site. In its place, any other static hosting site can be used, e.g. [Netlify](https://www.netlify.com/).
To publish directly, you can use:
```bash
yarn deploy:staging
```
> this will run a build and then publish to surge, ensure you change the domain name to something else though :). Current Staging URL is [here](https://fenestra.surge.sh/)
- [Github Pages](https://pages.github.com/)
Github Pages has been used as the production site for the blog. This can be changed to something else however. In its place, anything else can be used.
> this runs a buld and publishes to github pages.
> NB: Ensure that you change the [homepage](./package.json#homepage) attribute in the [package.json](./package.json) file to something else however.
You may add a Google Analytics Tracking ID, however,this is not necessary. To do so you will need to add it as an environment variable ANALYTICS_TRACKING_ID in any of the `.env.` of your choice. Sample environments have been provided to give more context:
```plain
.
└── .env.sample
```
In order to use the sample, simply rename the file by removing the `.sample` suffix.
The environment variables will be picked up at build time.
## Built With
1. [JavaScript Language](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/First_steps/What_is_JavaScript) - Programming language
2. [TypeScript](https://www.typescriptlang.org/) - Programming language
3. [ReactJS](https://reactjs.org/) - JavaScript library for building declarative UI.
## Versioning
[SemVer](https://semver.org/) is used for versioning. For the versions available, see the [tags](https://github.com/BrianLusina/brianlusina.github.io/tags) on this repository.
## License
This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
## Acknowledgements
A hat tip to [Unsplash](https://unsplash.com) for images and [Html5Up](https://html5up.net) for themes.