Skip to content

Commit f566a32

Browse files
committed
content first, then rants
1 parent c592b4a commit f566a32

File tree

1 file changed

+29
-19
lines changed

1 file changed

+29
-19
lines changed

README.md

Lines changed: 29 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4,27 +4,11 @@
44
git clone https://github.com/moofoo/nestjs-jsreport-examples && cd nestjs-jsreport-examples && yarn && yarn start:dev
55
```
66

7-
This repo demonstrates NestJS + JSReport integration. I've replicated all of the JSReport "[showcase](https://jsreport.net/showcases/)" reports minus the "PDF Stock Report", due to it's complexity. Like seriously, they went to town with that one. I also did a few of the simpler example reports from the [JSReport Playground](https://playground.jsreport.net/), just because.
7+
This repo demonstrates what you can do with the core JSReport libraries programmatically in your own NodeJS apps. Neither the JsReport 'Template Studio', their SaaS offerings, or any other SaaS provider, is involveds. All templating and report generation is performed locally by the NestJS server, using the JSReport 'renderer core' with the necessary extensions.
88

9-
The goal here is not to present a complete, self-contained and ready to use JSReports module, though that will probably happen eventually, with this repo being a big step in that direction. ('this repo' represents ~3 days worth of work integerating a completely unfamiliar code base, so adjust your expectations accordingly).
9+
The NestJS implementation is a work in progress. If you check back in a week or so, chances are it will be completely different.
1010

11-
Rather, I wanted to
12-
13-
- Demonstrate that the JSReport core libraries function adequately outside their usual web-based GUI context, as advertised.
14-
15-
- Towards that end, demonstrate the feasiblity and potential of integrating JsReport with NestJS in code (you're looking at it)
16-
17-
- Hopefully put something together that shows how powerful and fully-featured the core, low-level JSReport framework is on its own, to anyone paying attention. because I think it's cool.
18-
19-
#
20-
21-
#### **RANT**
22-
23-
JSReport, as far as I'm aware, is the only business reports company whose code base, top to bottem, is all open source and free for anyone to use. More impressively, they have intentionally architected their application as a collection of loosely coupled functional parts (extensions) that can be repurposd, mixed and matched, to perform useful work outside of their original Web GUI, Studio context. That is to say, outside the context where they make money for JSReport the business. And to top it all off, the core functionality on offer here, templating and doc gen, is **superlative**. Endless kudos.
24-
25-
Software like this really deserves more attention and love, especially given how crazy expensive and frankly predatory so many SaaS services in the space are.
26-
27-
#### **/RANT**
11+
I replicated all of the JSReport "[showcase](https://jsreport.net/showcases/)" reports minus the "PDF Stock Report", due . I also did a few of the simpler example reports from the [JSReport Playground](https://playground.jsreport.net/).
2812

2913
#
3014

@@ -107,3 +91,29 @@ Software like this really deserves more attention and love, especially given how
10791
#
10892

10993
Most of these will generate a PDF (instead .docx or .xlsx) with the query `pdf=1` (i.e, http://localhost:3333/reports/invoice?pdf=1)
94+
95+
#
96+
97+
#
98+
99+
## Commentary
100+
101+
The goal here is not to present a complete, self-contained and ready to use JSReports module, though that will probably happen eventually.
102+
103+
Rather, I wanted to
104+
105+
- Verify that the JSReport core libraries function adequately outside their usual web-based GUI context, as advertised.
106+
107+
- Towards that end, demonstrate the feasiblity and potential of integrating JsReport with NestJS in code (you're looking at it)
108+
109+
- Hopefully put something together that shows how powerful and fully-featured the core, low-level JSReport framework is on its own, to anyone paying attention. because I think it's cool.
110+
111+
#
112+
113+
#### **RANT**
114+
115+
JSReport, as far as I'm aware, is the only business reports company whose code base, top to bottem, is all open source and free for anyone to use. More impressively, they have intentionally architected their application as a collection of loosely coupled functional parts (extensions) that can be repurposd, mixed and matched, to perform useful work outside of their original Web GUI, Studio context. That is to say, outside the context where they make money for JSReport the business. And to top it all off, the core functionality on offer here, templating and doc gen, is **superlative**. Endless kudos.
116+
117+
Software like this really deserves more attention and love, especially given how crazy expensive and frankly predatory so many SaaS services in the space are.
118+
119+
#### **/RANT**

0 commit comments

Comments
 (0)