Skip to content

Commit 5ffa97f

Browse files
authored
docs(website): 📝 updating docs in progress with tutorials and guides (#1018)
1 parent 556129a commit 5ffa97f

Some content is hidden

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

53 files changed

+1253
-496
lines changed

README.md

Lines changed: 106 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -20,19 +20,19 @@
2020
<a href="https://github.com/BoykaFramework/boyka-framework/commits/main">
2121
<img src="https://img.shields.io/github/last-commit/BoykaFramework/boyka-framework?style=for-the-badge" alt="last update" />
2222
</a>
23+
<a href="https://github.com/BoykaFramework/boyka-framework/releases/latest">
24+
<img src="https://img.shields.io/github/downloads/BoykaFramework/boyka-framework/latest/total?color=brightgreen&label=Downloads%20for%20latest&logo=GitHub&style=for-the-badge" alt="GitHub releases" />
25+
</a>
2326
<a href="https://central.sonatype.com/artifact/io.github.boykaframework/boyka-framework">
2427
<img src="https://img.shields.io/maven-central/v/io.github.boykaframework/boyka-framework.svg?style=for-the-badge" alt="Maven Central" />
2528
</a>
26-
<a href="https://github.com/BoykaFramework/boyka-framework/releases/tag/v2.1.1">
27-
<img src="https://img.shields.io/github/downloads/BoykaFramework/boyka-framework/v2.1.1/total?color=brightgreen&label=Downloads%20for%20v2.1.1&logo=GitHub&style=for-the-badge" alt="GitHub releases" />
28-
</a>
2929
<a href="https://github.com/BoykaFramework/boyka-framework/blob/master/LICENSE">
3030
<img src="https://img.shields.io/github/license/BoykaFramework/boyka-framework.svg?style=for-the-badge" alt="license" />
3131
</a>
3232
</p>
3333

3434
<h4>
35-
<a href="https://BoykaFramework.github.io/boyka-framework/docs/intro">Documentation</a>
35+
<a href="https://boykaframework.github.io/boyka-framework/docs/intro">Documentation</a>
3636
<span> | </span>
3737
<a href="https://github.com/BoykaFramework/boyka-framework/issues/new/choose">Report Bug</a>
3838
<span> | </span>
@@ -42,6 +42,58 @@
4242

4343
<br />
4444

45+
## 🎯 Features
46+
47+
### Browsers
48+
49+
| OS | Windows | MacOS | Linux | Android | iOS |
50+
| -- | ------- | ----- | ----- | ------- | --- |
51+
| Chrome ||||| |
52+
| Firefox |||| | |
53+
| Safari | || | ||
54+
| Edge |||| | |
55+
56+
### Mobile applications
57+
58+
| OS | Android | iOS |
59+
| -- | ------- | --- |
60+
| Native |||
61+
| Hybrid |||
62+
| Web |||
63+
64+
### Remote platforms
65+
66+
| Platform | Status |
67+
| -------- | ------ |
68+
| BrowserStack ||
69+
| LambdaTest ||
70+
| Selenium Grid ||
71+
72+
### Test frameworks
73+
74+
| Framework | Java |
75+
| -------- | --- |
76+
| JUnit 5 ||
77+
| TestNG ||
78+
| Cucumber ||
79+
80+
### Other features
81+
82+
| Feature | Status |
83+
| ------- | ------ |
84+
| Zero boilerplate code ||
85+
| Page Object Model ||
86+
| Request object model ||
87+
| Single configuration ||
88+
| Page actions ||
89+
| Multi-user multi-platform ||
90+
| Take screenshots ||
91+
| Video recording (Mobile) ||
92+
| Logging ||
93+
| Extension support ||
94+
| Inline assertion ||
95+
| API response schema validation ||
96+
4597
## 🖱️ One command Boyka project setup
4698

4799
Install [Boyka command line assistant](https://github.com/BoykaFramework/boyka-cli) by running the following command:
@@ -63,31 +115,39 @@ When this command is executed, multiple set of questions will be prompted that m
63115
64116
## 👜 Resources
65117

66-
- [🤔 What is Boyka Framework?](https://BoykaFramework.github.io/boyka-framework/docs/intro#what-is-boyka-framework)
67-
- [💡 Why Boyka Framework was created?](https://BoykaFramework.github.io/boyka-framework/docs/intro#why-boyka-framework-was-created)
68-
- [🎯 Features](https://BoykaFramework.github.io/boyka-framework/docs/intro#features)
69-
- [🚀 Quick start](https://BoykaFramework.github.io/boyka-framework/docs/getting-started/quickstart)
118+
- [🤔 What is Boyka Framework?](https://boykaframework.github.io/boyka-framework/docs/intro#what-is-boyka-framework)
119+
- [💡 Why Boyka Framework was created?](https://boykaframework.github.io/boyka-framework/docs/intro#why-boyka-framework-was-created)
120+
- [🎯 Features](https://boykaframework.github.io/boyka-framework/docs/intro#features)
121+
- [🚀 Quick start](https://boykaframework.github.io/boyka-framework/docs/getting-started/quickstart)
70122

71123
## ☕ Examples
72124

125+
- [Create your first Boyka framework project](https://boykaframework.github.io/boyka-framework/docs/guides/create-first-project)
73126
- API:
74-
- [How to configure Boyka for API Automation?](https://BoykaFramework.github.io/boyka-framework/docs/guides/api/setup-config)
75-
- [How to compose a request?](https://BoykaFramework.github.io/boyka-framework/docs/guides/api/compose-request)
76-
- [How to execute a request?](https://BoykaFramework.github.io/boyka-framework/docs/guides/api/execute-request)
77-
- [How to verify the response?](https://BoykaFramework.github.io/boyka-framework/docs/guides/api/verify-response)
78-
- [How to verify the response schema?](http://localhost:3000/boyka-framework/docs/guides/api/verify-response-schema)
127+
- [How to configure Boyka for API Automation?](https://boykaframework.github.io/boyka-framework/docs/guides/api/setup-config)
128+
- [How to compose a request?](https://boykaframework.github.io/boyka-framework/docs/guides/api/compose-request)
129+
- [How to execute a request?](https://boykaframework.github.io/boyka-framework/docs/guides/api/execute-request)
130+
- [How to verify the response?](https://boykaframework.github.io/boyka-framework/docs/guides/api/verify-response)
131+
- [How to verify the response schema?](https://boykaframework.github.io/boyka-framework/docs/guides/api/verify-response-schema)
79132
- UI:
80133
- Web:
81-
- [How to configure Boyka for Web Automation?](https://BoykaFramework.github.io/boyka-framework/docs/guides/ui/web/setup-config)
82-
- [How to create page object for Web?](https://BoykaFramework.github.io/boyka-framework/docs/guides/ui/web/create-page-object)
134+
- [How to configure Boyka for Web Automation?](https://boykaframework.github.io/boyka-framework/docs/guides/ui/web/setup-config)
135+
- [How to create page object for Web?](https://boykaframework.github.io/boyka-framework/docs/guides/ui/web/create-page-object)
83136
- Android:
84-
- [How to configure Boyka for Android Automation?](https://BoykaFramework.github.io/boyka-framework/docs/guides/ui/android/setup-config)
85-
- [How to update existing page object with Android locators?](https://BoykaFramework.github.io/boyka-framework/docs/guides/ui/android/create-page-object)
137+
- [How to configure Boyka for Android Automation?](https://boykaframework.github.io/boyka-framework/docs/guides/ui/android/setup-config)
138+
- [How to update existing page object with Android locators?](https://boykaframework.github.io/boyka-framework/docs/guides/ui/android/create-page-object)
86139
- iOS:
87-
- [How to configure Boyka for iOS Automation?](https://BoykaFramework.github.io/boyka-framework/docs/guides/ui/ios/setup-config)
88-
- [How to update existing page object for iOS locators?](https://BoykaFramework.github.io/boyka-framework/docs/guides/ui/ios/create-page-object)
89-
- [How to create common application action class?](https://BoykaFramework.github.io/boyka-framework/docs/guides/ui/page-action)
90-
- [How to write test class using common action class?](https://BoykaFramework.github.io/boyka-framework/docs/guides/ui/write-test)
140+
- [How to configure Boyka for iOS Automation?](https://boykaframework.github.io/boyka-framework/docs/guides/ui/ios/setup-config)
141+
- [How to update existing page object for iOS locators?](https://boykaframework.github.io/boyka-framework/docs/guides/ui/ios/create-page-object)
142+
- [How to create common application action class?](https://boykaframework.github.io/boyka-framework/docs/guides/ui/page-actions)
143+
- [How to write test class using common action class?](https://boykaframework.github.io/boyka-framework/docs/guides/ui/write-test)
144+
145+
## 👨‍🎓 Tutorials
146+
147+
- [Appium with Selenium Grid 4](https://boykaframework.github.io/boyka-framework/docs/tutorials/appium-grid)
148+
- [How to automate i18n and l10n?](https://boykaframework.github.io/boyka-framework/docs/tutorials/i18n-l10n)
149+
- [Generate Allure Report](https://boykaframework.github.io/boyka-framework/docs/tutorials/generate-allure-report)
150+
- [Data Driven Testing](https://boykaframework.github.io/boyka-framework/docs/tutorials/data-driven-testing)
91151

92152
## 👾 Tech Stack
93153

@@ -119,13 +179,29 @@ When this command is executed, multiple set of questions will be prompted that m
119179
Big thanks to the following organizations for their support to the project with their open source licenses:
120180

121181
<div align="center">
122-
<a href="http://www.lambdatest.com?fp_ref=wasiq95" target="_blank" style="outline:none;border:none;"><img src="https://d2gdx5nv84sdx2.cloudfront.net/uploads/n3ufe5o3/marketing_asset/banner/6476/728_x_90.png" alt="lambdatest"/></a>
182+
<a href="http://www.lambdatest.com?fp_ref=wasiq95" target="_blank" style="outline:none;border:none;">
183+
<picture>
184+
<source media="(prefers-color-scheme: dark)" srcset="./website/static/img/docs/community/our-supporters/lambdatest-dark.png">
185+
<source media="(prefers-color-scheme: light)" srcset="./website/static/img/docs/community/our-supporters/lambdatest-light.png">
186+
<img alt="lambdatest" src="./website/static/img/docs/community/our-supporters/lambdatest-light.png">
187+
</picture>
188+
</a>
123189
<br/>
124-
<a href="https://www.browserstack.com/" target="_blank" style="outline:none;border:none;"><img src="./website/static/img/docs/community/our-supporters/browser-stack.png" alt="browserstack"/></a>
190+
<a href="https://www.browserstack.com/" target="_blank" style="outline:none;border:none;">
191+
<img src="./website/static/img/docs/community/our-supporters/browser-stack.png" alt="browserstack"/>
192+
</a>
125193
<br/>
126-
<a href="https://www.jetbrains.com/" target="_blank" style="outline:none;border:none;"><img src="./website/static/img/docs/community/our-supporters/jetbrains.png" alt="JetBrains" width="300px"/></a>
194+
<a href="https://www.jetbrains.com/" target="_blank" style="outline:none;border:none;">
195+
<picture>
196+
<source media="(prefers-color-scheme: dark)" srcset="./website/static/img/docs/community/our-supporters/jetbrains-white.png">
197+
<source media="(prefers-color-scheme: light)" srcset="./website/static/img/docs/community/our-supporters/jetbrains-black.png">
198+
<img alt="JetBrains" src="./website/static/img/docs/community/our-supporters/jetbrains-black.png">
199+
</picture>
200+
</a>
127201
<br/>
128-
<a href="https://tuple.app/" target="_blank" style="outline:none;border:none;"><img src="./website/static/img/docs/community/our-supporters/tuple.svg" alt="Tuple" width="300px"/></a>
202+
<a href="https://tuple.app/" target="_blank" style="outline:none;border:none;">
203+
<img src="./website/static/img/docs/community/our-supporters/tuple.svg" alt="Tuple" width="300px"/>
204+
</a>
129205
</div>
130206

131207
## 🧭 Project Road-map
@@ -141,7 +217,7 @@ Check out our road map to know which features we are cooking,
141217

142218
These are our awesome contributors:
143219

144-
[![Contributors](https://contrib.rocks/image?repo=BoykaFramework/boyka-framework)](https://github.com/BoykaFramework/boyka-framework/graphs/contributors)
220+
[![Repo contributors](https://contrib.rocks/image?repo=BoykaFramework/boyka-framework)](https://github.com/BoykaFramework/boyka-framework/graphs/contributors)
145221

146222
Contributions are always welcome!
147223

@@ -162,6 +238,10 @@ Distributed under MIT [License](LICENSE).
162238
- Connect with us on [X](https://dub.sh/boyka-twitter)
163239
- Follow us on [GitHub](https://git.new/boyka-github) and [LinkedIn](https://dub.sh/boyka-linkedin)
164240

241+
## 💗 Repo Activity
242+
243+
![Boyka Framework Repo activity](https://repobeats.axiom.co/api/embed/c0102808cee0d0c66a005dc18f95d3ef35a844a3.svg "Repobeats analytics image")
244+
165245
## ⭐ Star History
166246

167247
[![Star History Chart](https://api.star-history.com/svg?repos=BoykaFramework/boyka-framework&type=Timeline)](https://star-history.com/#BoykaFramework/boyka-framework&Timeline)

core-java/src/main/java/io/github/boykaframework/config/api/CommonApiSetting.java

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616

1717
package io.github.boykaframework.config.api;
1818

19+
import io.github.boykaframework.config.LanguageSetting;
1920
import lombok.Data;
2021

2122
/**
@@ -26,10 +27,11 @@
2627
*/
2728
@Data
2829
public class CommonApiSetting {
29-
private String basePath = "";
30-
private LogSetting logging = new LogSetting ();
31-
private String schemaPath = "";
32-
private TimeoutSetting timeout = new TimeoutSetting ();
33-
private boolean validateSsl = true;
34-
private boolean verifyHostName = true;
30+
private String basePath = "";
31+
private LanguageSetting language = new LanguageSetting ();
32+
private LogSetting logging = new LogSetting ();
33+
private String schemaPath = "";
34+
private TimeoutSetting timeout = new TimeoutSetting ();
35+
private boolean validateSsl = true;
36+
private boolean verifyHostName = true;
3537
}

core-java/test-suites/testng-web-bs.xml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,6 @@
2424
<parameter name="platformType" value="WEB"/>
2525
<parameter name="driverKey" value="test_browserstack_chrome"/>
2626
<packages>
27-
<package name="io.github.boykaframework.testng.ui.saucedemo"/>
2827
<package name="io.github.boykaframework.testng.ui.theinternet"/>
2928
</packages>
3029
</test>

core-java/test-suites/testng-web-grid.xml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,6 @@
2424
<parameter name="platformType" value="WEB"/>
2525
<parameter name="driverKey" value="test_selenium_grid"/>
2626
<classes>
27-
<class name="io.github.boykaframework.testng.ui.saucedemo.SauceDemoTest"/>
2827
<class name="io.github.boykaframework.testng.ui.theinternet.AlertsTest"/>
2928
<class name="io.github.boykaframework.testng.ui.theinternet.CheckboxTest"/>
3029
<class name="io.github.boykaframework.testng.ui.theinternet.ContextMenuTest"/>

core-java/test-suites/testng-web-local.xml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,6 @@
4141
<parameter name="platformType" value="WEB"/>
4242
<parameter name="driverKey" value="test_local_edge"/>
4343
<packages>
44-
<package name="io.github.boykaframework.testng.ui.saucedemo"/>
4544
<package name="io.github.boykaframework.testng.ui.theinternet"/>
4645
</packages>
4746
</test>

core-java/test-suites/testng-web-lt.xml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,6 @@
2424
<parameter name="platformType" value="WEB"/>
2525
<parameter name="driverKey" value="test_lambda_test_chrome"/>
2626
<packages>
27-
<package name="io.github.boykaframework.testng.ui.saucedemo"/>
2827
<package name="io.github.boykaframework.testng.ui.theinternet"/>
2928
</packages>
3029
</test>

package.json

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,18 +33,19 @@
3333
"@commitlint/cli": "^19.8.0",
3434
"@commitlint/config-conventional": "^19.8.0",
3535
"@eslint/compat": "^1.2.8",
36+
"@eslint/js": "^9.25.1",
3637
"@lerna/child-process": "^7.4.2",
3738
"@release-it-plugins/lerna-changelog": "^7.0.0",
3839
"@stylistic/eslint-plugin-js": "^4.2.0",
3940
"@stylistic/eslint-plugin-ts": "^4.2.0",
40-
"@types/node": "^22.14.1",
41-
"@typescript-eslint/eslint-plugin": "^8.30.1",
42-
"@typescript-eslint/parser": "^8.30.1",
41+
"@types/node": "^22.15.2",
42+
"@typescript-eslint/eslint-plugin": "^8.31.0",
43+
"@typescript-eslint/parser": "^8.31.0",
4344
"commitlint": "^19.8.0",
44-
"eslint": "^9.25.0",
45+
"eslint": "^9.25.1",
4546
"eslint-config-google": "^0.14.0",
4647
"eslint-config-prettier": "^10.1.2",
47-
"eslint-import-resolver-typescript": "^4.3.3",
48+
"eslint-import-resolver-typescript": "^4.3.4",
4849
"eslint-plugin-import": "^2.31.0",
4950
"eslint-plugin-prettier": "^5.2.6",
5051
"eslint-plugin-react": "^7.37.5",
@@ -56,14 +57,14 @@
5657
"lerna-version": "^6.6.2",
5758
"lint-staged": "^15.5.1",
5859
"lodash": "^4.17.21",
59-
"nx": "^20.8.0",
60+
"nx": "^20.8.1",
6061
"prettier": "^3.5.3",
6162
"react": "^19.1.0",
6263
"react-dom": "^19.1.0",
6364
"release-it": "^17.11.0",
6465
"ts-node": "^10.9.2",
6566
"typescript": "^5.8.3",
66-
"typescript-eslint": "^8.30.1"
67+
"typescript-eslint": "^8.31.0"
6768
},
6869
"scripts": {
6970
"preinstall": "npx only-allow pnpm",
@@ -99,5 +100,5 @@
99100
"pnpm format"
100101
]
101102
},
102-
"packageManager": "pnpm@10.7.1"
103+
"packageManager": "pnpm@10.9.0"
103104
}

0 commit comments

Comments
 (0)