Skip to content

Commit 91579c3

Browse files
authored
Merge pull request #47 from oslabs-beta/dev
Merge dev into master
2 parents a09c4dd + 9448e8a commit 91579c3

File tree

5 files changed

+43
-29
lines changed

5 files changed

+43
-29
lines changed

.github/workflows/dev.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name: dev branch sapling extension CI
1+
name: dev CI
22

33
# Run this workflow on PR into dev branch
44
on:

.github/workflows/master.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name: Master branch sapling extension CI/CD
1+
name: master CI/CD
22

33
# Run this workflow on PR into dev branch
44
on:

README.md

Lines changed: 29 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,9 @@
2626
<a href="https://github.com/oslabs-beta/sapling/stargazers"><img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/oslabs-beta/sapling"></a>
2727
<!-- GITHUB RELEASE VERSION -->
2828
<a href="https://github.com/oslabs-beta/sapling/releases"><img alt="GitHub release (latest by date including pre-releases)" src="https://img.shields.io/github/v/release/oslabs-beta/sapling?include_prereleases"></a>
29+
<!-- BUILD STATUS -->
30+
<a href="https://github.com/oslabs-beta/sapling/actions/workflows/master.yml"><img alt="master CI/CD workflow status" src="https://github.com/oslabs-beta/sapling/actions/workflows/master.yml/badge.svg"></a>
31+
<a href="https://github.com/oslabs-beta/sapling/actions/workflows/dev.yml"><img alt="dev CI workflow status" src="https://github.com/oslabs-beta/sapling/actions/workflows/dev.yml/badge.svg"></a>
2932
<!-- LICENSE -->
3033
<a href="https://github.com/oslabs-beta/sapling/blob/master/LICENSE"><img alt="GitHub" src="https://img.shields.io/github/license/oslabs-beta/sapling"></a>
3134
<!-- CONTRIBUTIONS -->
@@ -69,7 +72,9 @@
6972
## About The Project
7073

7174
<br/>
72-
<img width="1000" src="./sapling/media/quizwall_demo.gif">
75+
<p align="center">
76+
<img width="900" src="sapling/media/quizwall_demo.gif">
77+
</p>
7378
<br/>
7479

7580
Sapling is a VS Code extension built with React developers in mind. As your codebase grows, your native file structure becomes less and less intuitive. Wouldn't it be nice to have a file structure that represents the actual relationships between the components and containers in your application? Wouldn't you like a quick reference to your available props, and an indication of routes and conditional rendering?
@@ -79,24 +84,26 @@ With Sapling, you don't have to guess at the parent component of your current fi
7984

8085
### Built With
8186

82-
* [<img style="height: 1em;" src="sapling/media/react-brands.svg">]() [React](https://reactjs.org/)
83-
* [<img style="height: 1em;" src="sapling/media/vscode.svg">]() [VSCode Extension API](https://code.visualstudio.com/api)
84-
* [<img style="height: 1em;" src="sapling/media/mochajs-icon.svg">]() [Mocha](https://mochajs.org/)
85-
* [<img style="height: 1em;" src="sapling/media/chai_icon.svg">]() [Chai](https://www.chaijs.com/)
86-
* [<img style="height: 1em;" src="sapling/media/babel-logo-minimal.svg">]() [Babel Parser](https://babeljs.io/docs/en/babel-parser)
87-
* [<img style="height: 1em;" src="sapling/media/webpack.svg">]() [Webpack](https://webpack.js.org/)
88-
* [<img style="height: 1em;" src="sapling/media/github-actions.svg">]() [GitHub Actions](https://github.com/features/actions)
87+
* [<img style="height: 1em;" src="sapling/media/react-brands.svg">](https://reactjs.org/) [React](https://reactjs.org/)
88+
* [<img style="height: 1em;" src="sapling/media/vscode.svg">](https://code.visualstudio.com/api) [VSCode Extension API](https://code.visualstudio.com/api)
89+
* [<img style="height: 1em;" src="sapling/media/mochajs-icon.svg">](https://mochajs.org/) [Mocha](https://mochajs.org/)
90+
* [<img style="height: 1em;" src="sapling/media/chai_icon.svg">](https://www.chaijs.com/) [Chai](https://www.chaijs.com/)
91+
* [<img style="height: 1em;" src="sapling/media/babel-logo-minimal.svg">](https://babeljs.io/docs/en/babel-parser) [Babel Parser](https://babeljs.io/docs/en/babel-parser)
92+
* [<img style="height: 1em;" src="sapling/media/webpack.svg">](https://webpack.js.org/) [Webpack](https://webpack.js.org/)
93+
* [<img style="height: 1em;" src="sapling/media/github-actions.svg">](https://github.com/features/actions) [GitHub Actions](https://github.com/features/actions)
8994

9095
## Installation
9196

92-
Installing from VS Code Extension Marketplace (or downloading package from GitHub?).
97+
Installing from VS Code Extension Marketplace:
9398

9499
1. If needed, install Visual Studio Code for Windows (7+), macOS (Sierra+), or Linux (details).
95100

96101
2. Install the Sapling extension for Visual Studio Code.
97102

98103
3. Once complete, you'll see Sapling appear in your sidebar. You can now begin using Sapling! Check out the Getting Started below for information on how to get started.
99104

105+
To install sapling for development, please see the contributing section below.
106+
100107
## Getting Started
101108

102109
1. After installing VSCode Extension, you will see the extension on your sidebar. Click the "Choose a File" button.
@@ -113,7 +120,7 @@ Icon Legend in Sapling Tree View:
113120
* [<img style="height: 1em;" src="sapling/media/circle-info-solid.svg">]() available props (hover)
114121
* [<img style="height: 1em;" src="sapling/media/circle-arrow-right-solid.svg">]() open file (click)
115122
* [<img style="height: 1em;" src="sapling/media/store-solid.svg" >]() Redux store connection
116-
* [<span style='color:red;'>Navbar</span>](): error in file (matches the error color of your theme)
123+
* <span>Navbar</span>: error in file (matches the error color of your theme)
117124
* <b>Navbar</b>: currently open file
118125

119126
Sapling can currently display React apps made with TSX/JSX and ES6 import syntax.
@@ -128,7 +135,7 @@ Sapling will detect React components invoked using JSX tag syntax and React-Rout
128135
<Navbar></Navbar>
129136

130137
// Route and Navbar will be detected as child components of the current file
131-
<Route component={Navbar} />
138+
<Route component={Navbar} />
132139

133140
// Route and App will be detected as child components of the current file
134141
<Route children={App} />
@@ -138,7 +145,7 @@ Sapling will detect the names of inline props for JSX components it identifies:
138145

139146
```JSX
140147
// props 'userId' and 'userName' will be listed for Navbar in Sapling
141-
<Navbar userId={...} userName={...} />
148+
<Navbar userId={...} userName={...} />
142149
```
143150

144151
Sapling can identify components connected to the Redux store, when 'connect' is imported from 'react-redux', and the component is the export default of the file:
@@ -147,14 +154,14 @@ Sapling can identify components connected to the Redux store, when 'connect' is
147154
// App.jsx
148155
import React from 'react';
149156
import { connect } from 'react-redux';
150-
157+
151158
const mapStateToProps = ...
152159
const mapDispatchToProps = ...
153-
160+
154161
const App = (props) => {
155162
return <h1>This is the App</h1>
156163
}
157-
164+
158165
// Sapling will detect App as connected to the Redux store
159166
export default connect(mapStateToProps, mapDispatchToProps)(App);
160167
```
@@ -179,11 +186,11 @@ Sapling prioritizes file dependencies over component dependencies. Consider the
179186
}
180187
```
181188

182-
Sapling will display Home and Navbar as siblings, both children of App: (image of actual Sapling here)
189+
Sapling will display Home and Navbar as siblings, both children of App:
183190

184-
App
185-
- Home
186-
- Navbar
191+
<br />
192+
<img src="sapling/media/readme-example.png">
193+
<br />
187194

188195
### Contributor Usage
189196

@@ -200,8 +207,8 @@ Note: `Ctrl+R` (or `Cmd+R` on Mac) will refresh the extension development host
200207

201208
This extension contributes the following settings:
202209

203-
* `sapling.reactRouter`: enable/disable React Router component nodes
204-
* `sapling.thirdParty`: enable/disable all third party component nodes
210+
* `sapling.view.reactRouter`: enable/disable React Router component nodes
211+
* `sapling.view.thirdParty`: enable/disable all third party component nodes
205212

206213
## Contributing
207214

@@ -236,5 +243,5 @@ Distributed under the MIT License. See [`LICENSE`](https://github.com/oslabs-bet
236243
* Interactive tree view styling adapted from [Pure CSS Tree Menu](https://codepen.io/bisserof/pen/fdtBm)
237244
* Icons from [Font Awesome](https://fontawesome.com)
238245
* Tooltips with [Tippy](https://www.npmjs.com/package/@tippy.js/react)
239-
* [Best README Template](https://github.com/othneildrew/Best-README-Template)
246+
* [Best README Template](https://github.com/othneildrew/Best-README-Template)
240247
* Sapling Logo from [Freepik](https://www.freepik.com/vectors/tree)

sapling/README.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,9 @@
2828
<a href="https://github.com/oslabs-beta/sapling/stargazers"><img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/oslabs-beta/sapling"></a>
2929
<!-- GITHUB RELEASE VERSION -->
3030
<a href="https://github.com/oslabs-beta/sapling/releases"><img alt="GitHub release (latest by date including pre-releases)" src="https://img.shields.io/github/v/release/oslabs-beta/sapling?include_prereleases"></a>
31+
<!-- BUILD STATUS -->
32+
<a href="https://github.com/oslabs-beta/sapling/actions/workflows/master.yml"><img alt="master CI/CD workflow status" src="https://github.com/oslabs-beta/sapling/actions/workflows/master.yml/badge.svg"></a>
33+
<a href="https://github.com/oslabs-beta/sapling/actions/workflows/dev.yml"><img alt="dev CI workflow status" src="https://github.com/oslabs-beta/sapling/actions/workflows/dev.yml/badge.svg"></a>
3134
<!-- LICENSE -->
3235
<a href="https://github.com/oslabs-beta/sapling/blob/master/LICENSE"><img alt="GitHub" src="https://img.shields.io/github/license/oslabs-beta/sapling"></a>
3336
<!-- CONTRIBUTIONS -->
@@ -64,7 +67,9 @@
6467
## About The Project
6568

6669
<br/>
67-
<img width="1000" src="media/quizwall_demo.gif">
70+
<p align="center">
71+
<img width="900" src="media/quizwall_demo.gif">
72+
</p>
6873
<br/>
6974

7075
Sapling is a VS Code extension built with React developers in mind. As your codebase grows, your native file structure becomes less and less intuitive. Wouldn't it be nice to have a file structure that represents the actual relationships between the components and containers in your application? Wouldn't you like a quick reference to your available props, and an indication of routes and conditional rendering?
@@ -99,14 +104,16 @@ With Sapling, you don't have to guess at the parent component of your current fi
99104

100105
## Installation
101106

102-
Installing from VS Code Extension Marketplace (or downloading package from GitHub?).
107+
Installing from VS Code Extension Marketplace:
103108

104109
1. If needed, install Visual Studio Code for Windows (7+), macOS (Sierra+), or Linux (details).
105110

106111
2. Install the Sapling extension for Visual Studio Code.
107112

108113
3. Once complete, you'll see Sapling appear in your sidebar. You can now begin using Sapling! Check out the Getting Started below for information on how to get started.
109114

115+
To install sapling for development, please see the contributing section below.
116+
110117
## Getting Started
111118

112119
1. After installing VSCode Extension, you will see the extension on your sidebar. Click the "Choose a File" button.
@@ -203,9 +210,9 @@ Sapling prioritizes file dependencies over component dependencies. Consider the
203210

204211
Sapling will display Home and Navbar as siblings, both children of App: (image of actual Sapling here)
205212

206-
App
207-
- Home
208-
- Navbar
213+
<br />
214+
<img src="media/readme-example.png">
215+
<br />
209216

210217
## Extension Settings
211218

sapling/media/quizwall_demo.gif

2.22 MB
Loading

0 commit comments

Comments
 (0)