Skip to content

Commit 3e25ade

Browse files
committed
readme/doc
1 parent e899a6d commit 3e25ade

File tree

59 files changed

+9277
-30
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

59 files changed

+9277
-30
lines changed

README.md

Lines changed: 98 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
11
<!-- ⚠️ This README has been generated from the file(s) "blueprint.md" ⚠️-->This monorepo contains multiple packages:<br><br><details>
2-
<summary><b>ui-webview</b></summary>
3-
{{ load:packages/ui-webview/README.md }}
4-
</details><details>
52
<summary><b>webview</b></summary>
63
# @nativescript-community/ui-webview
74

@@ -238,4 +235,101 @@ install();
238235

239236
then simply use the `webRTC="true"` as a webview property
240237

241-
</details>
238+
</details>
239+
240+
[](#demos-and-development)
241+
242+
## Demos and Development
243+
244+
245+
### Repo Setup
246+
247+
The repo uses submodules. If you did not clone with ` --recursive` then you need to call
248+
```
249+
git submodule update --init
250+
```
251+
252+
The package manager used to install and link dependencies must be `pnpm` or `yarn`. `npm` wont work.
253+
254+
To develop and test:
255+
if you use `yarn` then run `yarn`
256+
if you use `pnpm` then run `pnpm i`
257+
258+
**Interactive Menu:**
259+
260+
To start the interactive menu, run `npm start` (or `yarn start` or `pnpm start`). This will list all of the commonly used scripts.
261+
262+
### Build
263+
264+
```bash
265+
npm run build.all
266+
```
267+
WARNING: it seems `yarn build.all` wont always work (not finding binaries in `node_modules/.bin`) which is why the doc explicitly uses `npm run`
268+
269+
### Demos
270+
271+
```bash
272+
npm run demo.[ng|react|svelte|vue].[ios|android]
273+
274+
npm run demo.svelte.ios # Example
275+
```
276+
277+
Demo setup is a bit special in the sense that if you want to modify/add demos you dont work directly in `demo-[ng|react|svelte|vue]`
278+
Instead you work in `demo-snippets/[ng|react|svelte|vue]`
279+
You can start from the `install.ts` of each flavor to see how to register new demos
280+
281+
282+
[](#contributing)
283+
284+
## Contributing
285+
286+
### Update repo
287+
288+
You can update the repo files quite easily
289+
290+
First update the submodules
291+
292+
```bash
293+
npm run update
294+
```
295+
296+
Then commit the changes
297+
Then update common files
298+
299+
```bash
300+
npm run sync
301+
```
302+
Then you can run `yarn|pnpm`, commit changed files if any
303+
304+
### Update readme
305+
```bash
306+
npm run readme
307+
```
308+
309+
### Update doc
310+
```bash
311+
npm run doc
312+
```
313+
314+
### Publish
315+
316+
The publishing is completely handled by `lerna` (you can add `-- --bump major` to force a major release)
317+
Simply run
318+
```shell
319+
npm run publish
320+
```
321+
322+
### modifying submodules
323+
324+
The repo uses https:// for submodules which means you won't be able to push directly into the submodules.
325+
One easy solution is t modify `~/.gitconfig` and add
326+
```
327+
[url "ssh://[email protected]/"]
328+
pushInsteadOf = https://github.com/
329+
```
330+
331+
[](#questions)
332+
333+
## Questions
334+
335+
If you have any questions/issues/comments please feel free to create an issue or start a conversation in the [NativeScript Community Discord](https://nativescript.org/discord).

docs/assets/highlight.css

Lines changed: 24 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,18 @@
11
:root {
2-
--light-hl-0: #000000;
3-
--dark-hl-0: #D4D4D4;
4-
--light-hl-1: #AF00DB;
5-
--dark-hl-1: #C586C0;
6-
--light-hl-2: #001080;
7-
--dark-hl-2: #9CDCFE;
8-
--light-hl-3: #A31515;
9-
--dark-hl-3: #CE9178;
10-
--light-hl-4: #795E26;
11-
--dark-hl-4: #DCDCAA;
2+
--light-hl-0: #795E26;
3+
--dark-hl-0: #DCDCAA;
4+
--light-hl-1: #000000;
5+
--dark-hl-1: #D4D4D4;
6+
--light-hl-2: #A31515;
7+
--dark-hl-2: #CE9178;
8+
--light-hl-3: #AF00DB;
9+
--dark-hl-3: #C586C0;
10+
--light-hl-4: #001080;
11+
--dark-hl-4: #9CDCFE;
12+
--light-hl-5: #008000;
13+
--dark-hl-5: #6A9955;
14+
--light-hl-6: #000000;
15+
--dark-hl-6: #C8C8C8;
1216
--light-code-background: #FFFFFF;
1317
--dark-code-background: #1E1E1E;
1418
}
@@ -19,6 +23,8 @@
1923
--hl-2: var(--light-hl-2);
2024
--hl-3: var(--light-hl-3);
2125
--hl-4: var(--light-hl-4);
26+
--hl-5: var(--light-hl-5);
27+
--hl-6: var(--light-hl-6);
2228
--code-background: var(--light-code-background);
2329
} }
2430

@@ -28,6 +34,8 @@
2834
--hl-2: var(--dark-hl-2);
2935
--hl-3: var(--dark-hl-3);
3036
--hl-4: var(--dark-hl-4);
37+
--hl-5: var(--dark-hl-5);
38+
--hl-6: var(--dark-hl-6);
3139
--code-background: var(--dark-code-background);
3240
} }
3341

@@ -37,6 +45,8 @@
3745
--hl-2: var(--light-hl-2);
3846
--hl-3: var(--light-hl-3);
3947
--hl-4: var(--light-hl-4);
48+
--hl-5: var(--light-hl-5);
49+
--hl-6: var(--light-hl-6);
4050
--code-background: var(--light-code-background);
4151
}
4252

@@ -46,6 +56,8 @@
4656
--hl-2: var(--dark-hl-2);
4757
--hl-3: var(--dark-hl-3);
4858
--hl-4: var(--dark-hl-4);
59+
--hl-5: var(--dark-hl-5);
60+
--hl-6: var(--dark-hl-6);
4961
--code-background: var(--dark-code-background);
5062
}
5163

@@ -54,4 +66,6 @@
5466
.hl-2 { color: var(--hl-2); }
5567
.hl-3 { color: var(--hl-3); }
5668
.hl-4 { color: var(--hl-4); }
69+
.hl-5 { color: var(--hl-5); }
70+
.hl-6 { color: var(--hl-6); }
5771
pre, code { background: var(--code-background); }

docs/assets/main.js

Lines changed: 55 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/assets/search.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/assets/style.css

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -483,10 +483,9 @@ blockquote {
483483
.has-menu .col-menu {
484484
visibility: visible;
485485
transform: translate(0, 0);
486-
display: grid;
487-
align-items: center;
488-
grid-template-rows: auto 1fr;
489-
grid-gap: 1.5rem;
486+
display: flex;
487+
flex-direction: column;
488+
gap: 1.5rem;
490489
max-height: 100vh;
491490
padding: 1rem 2rem;
492491
}
@@ -911,7 +910,7 @@ a.tsd-index-link {
911910
margin-right: 0.8rem;
912911
}
913912

914-
@media (min-width: 1024px) {
913+
@media (min-width: 1025px) {
915914
.col-content {
916915
margin: 2rem auto;
917916
}

0 commit comments

Comments
 (0)