You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://github.com/serenity-js/serenity-js)
5
-
[](https://stackoverflow.com/questions/tagged/serenity-js)
6
-
[](https://gitpod.io/from-referrer/)
[](https://www.linkedin.com/company/serenity-js)
9
-
[](https://www.youtube.com/@serenity-js)
10
-
[](https://matrix.to/#/#serenity-js:gitter.im)
11
-
[](https://github.com/sponsors/serenity-js)
12
-
13
-
Use this [template repository](https://help.github.com/en/articles/creating-a-repository-from-a-template)
14
-
to get started with testing your [Lit](https://lit.dev/) or native [Web Components](https://developer.mozilla.org/en-US/docs/Web/API/Web_components)
15
-
using [Serenity/JS](https://serenity-js.org), [Playwright](https://playwright.dev/), [Playwright Component Test](https://playwright.dev/docs/test-components)
16
-
and [Playwright CT Web](https://github.com/sand4rt/playwright-ct-web).
5
+
This [template](https://help.github.com/en/articles/creating-a-repository-from-a-template) helps you test
6
+
[Lit](https://lit.dev/) and native [Web Components](https://developer.mozilla.org/en-US/docs/Web/API/Web_components)
7
+
using [Serenity/JS](https://serenity-js.org) and the [Playwright Test](https://playwright.dev/) runner with [Playwright CT Web](https://github.com/sand4rt/playwright-ct-web),
8
+
with a fully configured TypeScript setup.
17
9
18
-
Learn more:
19
-
-[Serenity BDD reports for this project](https://serenity-js.github.io/serenity-js-playwright-ct-web-components-template/serenity/)
20
-
-[Playwright Test reports for this project](https://serenity-js.github.io/serenity-js-playwright-ct-web-components-template/playwright/)
21
-
-[Serenity/JS website, tutorials, and API docs](https://serenity-js.org/)
- Ready-to-use GitHub Codespaces environment using the official [Serenity/JS Docker image](https://serenity-js.org/handbook/integration/docker/) for quick exploration
16
+
- Integrated reporting via Serenity BDD and Playwright, with live examples:
-[Playwright Test report](https://serenity-js.github.io/serenity-js-playwright-ct-web-components-template/playwright/)
24
19
25
-
This repository is a GitHub template. You can use it to [create a new GitHub repository](https://help.github.com/en/articles/creating-a-repository-from-a-template), [clone it to your computer](https://docs.github.com/en/free-pro-team@latest/github/creating-cloning-and-archiving-repositories/cloning-a-repository).
20
+
## Quick Start
26
21
27
-
You can also launch it in a virtual Gitpod workspace without having to install anything on your machine:
22
+
### Explore instantly in GitHub Codespaces
28
23
29
-
[](https://gitpod.io/from-referrer/)
24
+
Launch this project in an online development environment:
30
25
31
-
### Installation
26
+
[](https://github.com/codespaces/new?ref=main&repo=serenity-js/serenity-js-playwright-ct-web-components-template)
32
27
33
-
To use this project on your machine, you'll need:
34
-
- Node.js, a Long-Term Support (LTS) release version 16 or later - [download](https://nodejs.org/en/)
35
-
- Java Runtime Environment (JRE) or a Java Development Kit (JDK) version 11 or later - [download](https://adoptopenjdk.net/)
28
+
### Run locally
36
29
37
-
Follow the [installation instructions](https://serenity-js.org/handbook/about/installation/) to help you verify your setup.
38
-
39
-
Once you have the code on your computer, use your computer terminal to run the following command in the directory where you've cloned the project:
30
+
- Follow the [Serenity/JS installation guide](https://serenity-js.org/handbook/about/installation/)
31
+
-[Create a new repository](https://help.github.com/en/articles/creating-a-repository-from-a-template) from this template
32
+
-[Clone](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository) it to your machine
33
+
- Install dependencies:
40
34
```
41
35
npm ci
42
36
```
43
-
44
-
Running [`npm ci`](https://docs.npmjs.com/cli/v6/commands/npm-ci) downloads the [Node modules](https://docs.npmjs.com/about-packages-and-modules) this project depends on, as well as the [Serenity BDD CLI](https://github.com/serenity-bdd/serenity-cli) reporter jar.
Then open [http://localhost:8080](http://localhost:8080) in your browser.
45
49
46
50
### Corporate networks
47
51
48
-
If your network administrators require you to use proxy servers or an internal artifact registry (Artifactory, Nexus, etc.), your development environment might require some additional configuration.
49
-
50
-
The easiest way to do it is to create an [`.npmrc` file](https://docs.npmjs.com/cli/v6/configuring-npm/npmrc) in your home directory:
52
+
If your environment requires proxy configuration or an internal registry like Artifactory or Nexus, add an [`.npmrc` file](https://docs.npmjs.com/cli/v6/configuring-npm/npmrc) file
53
+
with the appropriate configuration to your home directory:
If you encounter issues downloading the Serenity BDD CLI jar, please follow the [detailed instructions in the Serenity/JS Handbook](https://serenity-js.org/api/serenity-bdd/#downloading-the-serenity-bdd-reporting-cli).
60
-
61
-
### Execution
62
+
## Execution
62
63
63
64
The project provides several [NPM scripts](https://docs.npmjs.com/cli/v6/using-npm/scripts) defined in [`package.json`](package.json):
64
65
@@ -72,25 +73,58 @@ npm start # starts a mini HTTP server and serves the test reports
72
73
# at http://localhost:8080
73
74
```
74
75
75
-
## Your feedback matters!
76
+
## Next steps
77
+
78
+
- Replace the sample components with your own UI elements
79
+
- Add new tasks, interactions, and assertions using Serenity/JS
80
+
- Extend the test suite or integrate it into CI/CD pipelines
81
+
- Use the sample reports to understand expected testing and reporting workflows
76
82
77
-
Do you find Serenity/JS useful? Give it a ⭐ star on GitHub!
-[More examples and reference implementations](https://github.com/serenity-js/serenity-js/tree/main/examples)
89
+
-[Tutorial: First Web Scenario](https://serenity-js.org/handbook/tutorials/your-first-web-scenario/)
90
+
-[Tutorial: First API Scenario](https://serenity-js.org/handbook/tutorials/your-first-api-scenario/)
80
91
81
-
Found a bug? Need a feature? Raise [an issue](https://github.com/serenity-js/serenity-js/issues?state=open)
82
-
or submit a pull request.
92
+
## Contributing
83
93
84
-
Have feedback? Let me know on [LinkedIn](https://www.linkedin.com/in/janmolak/) or leave a comment in [Serenity/JS discussions on GitHub](/serenity-js/serenity-js/discussions/categories/comments).
94
+
Contributions of all kinds are welcome! Get started with the [Contributing Guide](https://serenity-js.org/community/contributing/).
85
95
86
-
And if you have any questions about the framework, or simply want to say hello to other Serenity/JS developers, join us on [Serenity/JS Community Chat](https://matrix.to/#/#serenity-js:gitter.im).
96
+
## Community
87
97
88
-
## Support Serenity/JS
98
+
[](https://www.linkedin.com/company/serenity-js)
99
+
[](https://www.youtube.com/@serenity-js)
100
+
[](https://matrix.to/#/#serenity-js:gitter.im)
101
+
102
+
Connect with other developers using Serenity/JS:
103
+
104
+
-[Updates on LinkedIn](https://www.linkedin.com/company/serenity-js)
- Explore the [💡How to... ?](https://github.com/orgs/serenity-js/discussions/categories/how-to) answers to common questions
108
+
109
+
Follow Serenity/JS to learn about new features, tutorials, and releases!
110
+
111
+
⭐ Star the main [Serenity/JS repository](https://github.com/serenity-js/serenity-js) to help others discover the framework!
89
112
90
-
Serenity/JS is a free open-source framework, so we rely on our [wonderful GitHub sponsors](https://github.com/sponsors/serenity-js) to keep the lights on.
If you appreciate all the effort that goes into making sophisticated tools easy to work with, please support our work and [become a Serenity/JS GitHub Sponsor](https://github.com/sponsors/serenity-js) today!
115
+
## License
116
+
117
+
The Serenity/JS code base is licensed under the [Apache-2.0](https://opensource.org/license/apache-2-0) license,
118
+
while its documentation and the [Serenity/JS Handbook](https://serenity-js.org/handbook/) are licensed under the [Creative Commons BY-NC-SA 4.0 International](https://creativecommons.org/licenses/by-nc-sa/4.0/).
119
+
120
+
See the [Serenity/JS License](https://serenity-js.org/legal/license/).
121
+
122
+
## Support
123
+
124
+
Support ongoing development through [GitHub Sponsors](https://github.com/sponsors/serenity-js). Sponsors gain access to [Serenity/JS Playbooks](https://github.com/serenity-js/playbooks)
125
+
and priority help in the [Discussions Forum](https://github.com/orgs/serenity-js/discussions).
126
+
127
+
For commercial support or corporate sponsorship, please contact [Jan Molak](https://www.linkedin.com/in/janmolak/).
0 commit comments