https://github.com/btoms20/asyncplottabler
Prebuilt Tabler Components for Async HTML Rendering in Vapor
https://github.com/btoms20/asyncplottabler
plot swift swift-server tabler tabler-ui vapor vapor-swift
Last synced: 12 months ago
JSON representation
Prebuilt Tabler Components for Async HTML Rendering in Vapor
- Host: GitHub
- URL: https://github.com/btoms20/asyncplottabler
- Owner: btoms20
- License: mit
- Created: 2024-02-01T05:05:12.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-27T23:48:00.000Z (over 1 year ago)
- Last Synced: 2025-01-15T10:57:14.604Z (over 1 year ago)
- Topics: plot, swift, swift-server, tabler, tabler-ui, vapor, vapor-swift
- Language: Swift
- Homepage: https://vpt.btoms20.com
- Size: 993 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AsyncPlotTabler
Prebuilt Tabler Components for Async HTML Rendering in Vapor
#### What's [Plot](https://github.com/JohnSundell/Plot)?
> Plot, a domain-specific language (DSL) for writing type-safe HTML, XML and RSS in Swift. It can be used to build websites, documents and feeds, as a templating tool, or as a renderer for higher-level components and tools. It’s primary focus is on static site generation and Swift-based web development.
#### What's [Tabler](https://github.com/tabler/tabler)?
> Tabler is fully responsive and compatible with all modern browsers. Thanks to its modern and user-friendly design you can create a fully functional interface that users will love! Choose the layouts and components you need and customize them to make your design consistent and eye-catching. Every component has been created with attention to detail to make your interface beautiful!
#### What's [Vapor](https://github.com/vapor/vapor)?
> Vapor is an HTTP web framework for Swift. It provides a beautifully expressive and easy-to-use foundation for your next website, API, or cloud project.
### When we combine these three powerful technologies, something revolutionary[^1] happens...
#### 🔥 Check out the [Demo Website](https://vpt.btoms20.com)
> [!NOTE]
> This is just a hosted version of the `Demo` executable included within this package
## Local Demos
#### 🔥 Tablers Demo Website
- Run the `Demo` target within Xcode
- Or execute `swift run Demo`
#### ✅ A Todo Demo
The only thing missing from [Vapor's awesome Todo example](https://github.com/vapor/template-fluent-postgres) is a UI to interact with your fancy new API!
- Make sure your Postgres (or DB of choice) server is up, running and reachable
- Run the `Todo` target within Xcode
- Or execute `swift run Todo`
#### 📔 A Blog Demo (check out the [hosted demo](https://vpt-blog.btoms20.com))
Want to set up a Micro Blog written entirely in Swift?? Here's a template to get you started!
- Run the `Blog` target within Xcode
- Or execute `swift run Blog`
> [!IMPORTANT]
> Before running any of the demos or deploying your own app...
> You need to create a `Public` dir in your apps working directory with Tablers [`static`](https://github.com/tabler/tabler/tree/dev/demo/static) and [`dist`](https://github.com/tabler/tabler/tree/dev/dist) assets with the following structure
> ``` bash
> ├── Public
> │ ├── static/
> │ ├── libs/
> │ ├── img/
> │ ├── js/
> │ └── css/
> ```
## API
``` swift
// TODO
```
## Contributing
Contributions are welcomed! This code is very much a proof of concept. I can guarantee you there's a better / safer way to accomplish the same results. Any suggestions, improvements, or even just critiques, are welcome!
Let's make this code better together! 🤝
## Credits
- [swift-nio](https://github.com/apple/swift-nio)
- [Vapor](https://github.com/vapor/vapor)
- [Plot](https://github.com/JohnSundell/Plot)
- [Tabler](https://github.com/tabler/tabler)
## License
[MIT](LICENSE) 2024
[^1]: There's no evidence to support this claim