Skip to content

Commit 12d805c

Browse files
authored
Readme - Setup Steps Update (#206)
* improved markdown in README, markdownLint complient * added missing dependencies, fixes some warnings for fresh environments * updated setup steps * updated port to 3000 * added script for local development
1 parent f20452a commit 12d805c

File tree

2 files changed

+39
-32
lines changed

2 files changed

+39
-32
lines changed

README.md

Lines changed: 32 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -2,45 +2,49 @@
22

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

5-
### Table of contents
6-
7-
- Requirements
8-
- Installation
9-
- File Structure
10-
- How to contribute
11-
- Credits
12-
13-
## Requirements
14-
Following applications are required to run the application locally.
15-
16-
- Git
17-
- Npm
18-
- Node
5+
## Table of contents
6+
7+
- Requirements
8+
- Installation
9+
- File Structure
10+
- How to contribute
11+
- Credits
12+
13+
## Requirements
14+
15+
Following applications are required to run the application locally.
16+
17+
- Git
18+
- Npm
19+
- Node
1920

2021
## Installation
22+
2123
To run the application on your local system follow these steps
2224

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

2933
## File Structure
3034

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

3741
## Dockerizing the application
3842

39-
### To use the application in docker for both production and development use, follow:
43+
### To use the application in docker for both production and development use, follow
4044

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

43-
- 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>
47+
- Running docker image ` lakshyadocker run -it -v ${PWD}:/app -v /app/node_modules -p {Port-you-want-your-app-on}:3000 --rm {docker-image} `
4448

4549
## How to contribute
4650

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

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

53-
* Report an error you can’t solve yourself
54-
* Discuss a high-level topic or idea (for example, community, vision or policies)
55-
* Propose a new feature or other project idea
57+
- Report an error you can’t solve yourself
58+
- Discuss a high-level topic or idea (for example, community, vision or policies)
59+
- Propose a new feature or other project idea
5660

5761
**Tips for communicating on issues:**
5862

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

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

69-
* Submit trivial fixes (for example, a typo, a broken link or an obvious error)
70-
* Start work on a contribution that was already asked for, or that you’ve already discussed, in an issue
73+
- Submit trivial fixes (for example, a typo, a broken link or an obvious error)
74+
- Start work on a contribution that was already asked for, or that you’ve already discussed, in an issue
7175
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.
7276

7377
## Credits

package.json

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
"@testing-library/react": "^9.4.0",
99
"@testing-library/user-event": "^7.2.1",
1010
"axios": "^0.19.2",
11+
"enzyme": "^3.11.0",
1112
"highlight.js": "^9.17.1",
1213
"history": "^4.10.1",
1314
"html-to-markdown": "^1.0.0",
@@ -35,17 +36,19 @@
3536
"react-slideshow-image": "^1.3.3",
3637
"react-twitter-embed": "^3.0.3",
3738
"semantic-ui-react": "^0.88.2",
38-
"serve": "^11.3.0"
39+
"serve": "^11.3.0",
40+
"typescript": "^3.9.6"
3941
},
4042
"resolutions": {
4143
"react-dev-utils": "10.1.0"
4244
},
4345
"scripts": {
4446
"heroku-postbuild": "npm run build",
45-
"start": "serve -s build",
46-
"build": "set \"CI=false\" && react-scripts build",
47+
"start": "serve -s build -l 3000",
48+
"build": "CI=false && set \"CI=false\" && react-scripts build",
4749
"test": "react-scripts test",
48-
"eject": "react-scripts eject"
50+
"eject": "react-scripts eject",
51+
"start-dev": "react-scripts start"
4952
},
5053
"eslintConfig": {
5154
"extends": "react-app"

0 commit comments

Comments
 (0)