Skip to content

Readme - Setup Steps Update #206

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jul 6, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 32 additions & 28 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,45 +2,49 @@

Offical site for Codeuino landing page. Please visit [http://www.codeuino.org/](http://www.codeuino.org/)

### Table of contents

- Requirements
- Installation
- File Structure
- How to contribute
- Credits

## Requirements
Following applications are required to run the application locally.

- Git
- Npm
- Node
## Table of contents

- Requirements
- Installation
- File Structure
- How to contribute
- Credits

## Requirements

Following applications are required to run the application locally.

- Git
- Npm
- Node

## Installation

To run the application on your local system follow these steps

1. <code>git clone https://github.com/codeuino/website-www.codeuino.org.git</code>
1. `git clone https://github.com/codeuino/website-www.codeuino.org.git`
2. Move to the project directory.
3. <code>git checkout development</code>
4. <code>npm install</code>
5. Open <code>localhost:3000</code> to view the website on your local browser.
3. `git checkout development`
4. `npm install`
5. `npm run build`
6. `npm start`
7. Open `localhost:5000` to view the website on your local browser.

## File Structure

This section describes about the file structure of the project.
All the source code is located in <code>src</code> directory.
There are two main directories in the src folder, <code>components</code> and <code>pages</code>.
All the source code is located in `src` directory.
There are two main directories in the src folder, `components` and `pages`.
The pages directory contains all the source code of routes in separate folders.
The components directory contains all reusable component file in separate folders.

## Dockerizing the application

### To use the application in docker for both production and development use, follow:
### To use the application in docker for both production and development use, follow

- Build and tag docker image <code> docker image build -f Dockerfile-dev -t {name-of-docker-file-of-your-choice} . </code>
- Build and tag docker image ` docker image build -f Dockerfile-dev -t {name-of-docker-file-of-your-choice} . `

- Running docker image <code> lakshyadocker run -it -v ${PWD}:/app -v /app/node_modules -p {Port-you-want-your-app-on}:3000 --rm {docker-image} </code>
- Running docker image ` lakshyadocker run -it -v ${PWD}:/app -v /app/node_modules -p {Port-you-want-your-app-on}:3000 --rm {docker-image} `

## How to contribute

Expand All @@ -50,9 +54,9 @@ The components directory contains all reusable component file in separate folder

You should usually [open an issue](https://github.com/codeuino/website-www.codeuino.org/issues/new) in the following situations:

* Report an error you can’t solve yourself
* Discuss a high-level topic or idea (for example, community, vision or policies)
* Propose a new feature or other project idea
- Report an error you can’t solve yourself
- Discuss a high-level topic or idea (for example, community, vision or policies)
- Propose a new feature or other project idea

**Tips for communicating on issues:**

Expand All @@ -66,8 +70,8 @@ If you opened an issue, but figured out the answer later on your own, comment on

You should usually open a pull request in the following situations:

* Submit trivial fixes (for example, a typo, a broken link or an obvious error)
* Start work on a contribution that was already asked for, or that you’ve already discussed, in an issue
- Submit trivial fixes (for example, a typo, a broken link or an obvious error)
- Start work on a contribution that was already asked for, or that you’ve already discussed, in an issue
A pull request doesn’t have to represent finished work. It’s usually better to open a pull request early on, so others can watch or give feedback on your progress. Just mark it as a “WIP” (Work in Progress) in the subject line. You can always add more commits later.

## Credits
Expand Down
11 changes: 7 additions & 4 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
"@testing-library/react": "^9.4.0",
"@testing-library/user-event": "^7.2.1",
"axios": "^0.19.2",
"enzyme": "^3.11.0",
"highlight.js": "^9.17.1",
"history": "^4.10.1",
"html-to-markdown": "^1.0.0",
Expand Down Expand Up @@ -35,17 +36,19 @@
"react-slideshow-image": "^1.3.3",
"react-twitter-embed": "^3.0.3",
"semantic-ui-react": "^0.88.2",
"serve": "^11.3.0"
"serve": "^11.3.0",
"typescript": "^3.9.6"
},
"resolutions": {
"react-dev-utils": "10.1.0"
},
"scripts": {
"heroku-postbuild": "npm run build",
"start": "serve -s build",
"build": "set \"CI=false\" && react-scripts build",
"start": "serve -s build -l 3000",
"build": "CI=false && set \"CI=false\" && react-scripts build",
"test": "react-scripts test",
"eject": "react-scripts eject"
"eject": "react-scripts eject",
"start-dev": "react-scripts start"
},
"eslintConfig": {
"extends": "react-app"
Expand Down