@@ -10,11 +10,18 @@ analyses directly within your GitHub Actions CI/CD workflow and Pull Requests.
1010Choose from a variety of pre-built reports or create custom reports tailored to
1111your project's needs, ensuring that test results are always where you need them.
1212
13+
14+ <div align =" center " >
15+ <h2 >⭐ Support Us ⭐</h2 >
16+ <h3 >If you like what you see, drop us a star ⭐</h3 >
17+ <h3 >It helps more teams find the project and motivates us to keep building! 💚</h3 >
18+ </div >
19+
20+
1321<div align =" center " >
1422<div style =" padding : 1.5rem ; border-radius : 8px ; margin : 1rem 0 ; border : 1px solid #30363d ;" >
1523<span style =" font-size : 23px ;" >💚</span >
1624<h3 style =" margin : 1rem 0 ;" >CTRF tooling is open source and free to use</h3 >
17- <p style =" font-size : 16px ;" >You can support the project with a follow and a star</p >
1825
1926<div style =" margin-top : 1.5rem ;" >
2027<a href =" https://github.com/ctrf-io/github-test-reporter " >
@@ -27,63 +34,35 @@ your project's needs, ensuring that test results are always where you need them.
2734</div >
2835
2936<p style =" font-size : 14px ; margin : 1rem 0 ;" >
30- Maintained by <a href =" https://github.com/ma11hewthomas " >Matthew Thomas</a ><br />
3137Contributions are very welcome! <br />
3238Explore more <a href =" https://www.ctrf.io/integrations " >integrations</a >
3339</p >
3440</div >
3541
3642## Key Features
3743
38- ### 📊 Comprehensive Test Reports
39-
40- Access powerful built-in reports including:
41-
42- - 📈 Historical Test Trends
43- - 📝 Detailed Test Results
44- - ❌ Failed Tests Overview
45- - 🔁 Flaky Tests Analysis
46-
47- ### 🎨 Custom Report Builder
48-
49- Create and customize your own test reports with our flexible templating system.
50- Perfect for teams with specific reporting needs or unique project requirements.
51-
52- ### 🤖 AI-Powered Test Analysis
53-
54- Get intelligent insights on test failures with our AI-generated reports. Quickly
55- understand why tests failed and how to fix them using leading AI models.
56-
57- ### 🔌 Universal Framework Support
58-
59- Compatible with all major testing frameworks through standardized CTRF reports
60-
61- ## Report Showcase
62-
63- Checkout all the built-in reports [ here] ( docs/report-showcase.md )
64-
65- ## Visual Overview
66-
67- | ![ all] ( images/all.png ) | ![ ai] ( images/github-failed.png ) | ![ flaky-rate] ( images/insights.png ) | ![ historical] ( images/historical.png ) | ![ pr] ( images/pr.png ) |
68- | :--------------------------------------: | :----------------------------------------: | :----------------------------------: | :--------------------------: | :----------------------------------: |
69- | ![ suite-folded] ( images/suite-folded.png ) | ![ ai] ( images/ai.png ) | ![ custom] ( images/custom.png ) | ![ failed] ( images/failed.png ) | ![ suite-list] ( images/suite-list.png ) |
44+ - 🧩 Post anywhere — job summaries, pull requests, checks, issues, inline annotations, and other developer tools
45+ - 📊 Built-in insights for failures, flaky tests, and trends across hundreds of runs
46+ - 🧘 Super flexible — start fast with powerful built-in reports or go fully custom with your own templates
47+ - 🤖 AI-powered analysis explains why tests failed — and how to fix them
48+ - 🔌 Framework-agnostic — works with any testing tool
7049
7150## Table of Contents
7251
73521 . [ Usage] ( #usage )
74- 2 . [ Available Inputs ] ( #available-inputs )
75- 3 . [ Pull Requests ] ( #pull-requests )
76- 4 . [ Status Checks ] ( #status-checks )
77- 5 . [ Build Your Own Report ] ( #build-your-own-report )
78- 6 . [ Customizing Report Order ] ( #customizing-report-order )
79- 7 . [ Community Reports ] ( #community-reports )
80- 8 . [ GitHub Token ] ( #github-token )
81- 9 . [ Storing Artifacts ] ( #storing-artifacts )
82- 10 . [ Filtering ] ( #filtering )
83- 11 . [ Integrations ] ( #integrations )
84- 12 . [ Generating an AI Report ] ( #generating-an-ai-report )
85- 13 . [ Run With NPX ] ( #run-with-npx )
86- 14 . [ Report Showcase ] ( #report-showcase )
53+ 2 . [ Report Showcase ] ( #report-showcase )
54+ 3 . [ Visual Overview ] ( #visual-overview )
55+ 4 . [ Available Inputs ] ( #available-inputs )
56+ 5 . [ Pull Requests ] ( #pull-requests )
57+ 6 . [ Status Checks ] ( #status-checks )
58+ 7 . [ Build Your Own Report ] ( #build-your-own-report )
59+ 8 . [ Customizing Report Order ] ( #customizing-report-order )
60+ 9 . [ Community Reports ] ( #community-reports )
61+ 10 . [ GitHub Token ] ( #github-token )
62+ 11 . [ Storing Artifacts ] ( #storing-artifacts )
63+ 12 . [ Filtering ] ( #filtering )
64+ 13 . [ Integrations ] ( #integrations )
65+ 14 . [ Generating an AI Report ] ( #generating-an-ai-report )
876615 . [ What is CTRF?] ( #what-is-ctrf )
8867
8968## Usage
@@ -95,25 +74,31 @@ To get started add the following to your workflow file:
9574 uses : ctrf-io/github-test-reporter@v1
9675 with :
9776 report-path : ' ./ctrf/*.json'
77+ github-report : true
9878 if : always()
9979` ` `
10080
101- This will publish the default reports ` summary-report`, `failed-report`,
102- ` flaky-report` , `skipped-report`, and `test-report` to the job summary.
81+ ## Report Showcase
82+
83+ Checkout all the built-in reports [here](docs/report-showcase.md)
84+
85+ ## Visual Overview
86+
87+ |  |  |  |  |  |
88+ | :--------------------------------------: | :----------------------------------------: | :----------------------------------: | :--------------------------: | :----------------------------------: |
89+ |  |  |  |  |  |
10390
104- # # Generate a CTRF report
91+ ## Generate a report
10592
106- [CTRF reporters](https://ctrf.io/integrations) are available for
107- most testing frameworks and easy to install.
93+ You need a CTRF or JUnit report.
10894
109- **No CTRF reporter? No problem!**
95+ This reporter works best with a CTRF as it's packed with modern properties. [CTRF reporters](https://ctrf.io/integrations) are available for most testing frameworks and easy to install.
11096
111- Use the [JUnit to CTRF integration](docs/integrations.md#junit-to-ctrf-integration) or [junit-to-ctrf](https://github.com/ctrf-io/junit-to-ctrf) cli to convert a JUnit
112- report to CTRF.
97+ For more details on using JUnit, see [JUnit integration instructions](docs/integrations.md#junit-to-ctrf-integration)
11398
11499## Available Inputs
115100
116- There are several inputs available
101+ For more advanced usage, there are several inputs available.
117102
118103` ` ` yaml
119104- name : Publish Test Report
@@ -123,7 +108,7 @@ There are several inputs available
123108 report-path : ' ./ctrf/*.json' # Path or glob pattern to the CTRF report JSON file.
124109 template-path : ' ./templates/custom-summary.hbs' # Path to the Handlebars template for customizing markdown output.
125110
126- # Reports - Choose as many as you like. Default is false
111+ # Reports - Choose as many as you like. Default is false. Choosing none will use default reports.
127112 summary-report : true
128113 github-report : false
129114 test-report : false
0 commit comments