Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/badgerati/pode.web

Web template framework for use with the Pode PowerShell web server
https://github.com/badgerati/pode.web

framework hacktoberfest pode powershell templates web

Last synced: 4 days ago
JSON representation

Web template framework for use with the Pode PowerShell web server

Host: GitHub
URL: https://github.com/badgerati/pode.web
Owner: Badgerati
License: mit
Created: 2020-11-15T16:31:05.000Z (almost 4 years ago)
Default Branch: develop
Last Pushed: 2024-10-15T23:34:27.000Z (21 days ago)
Last Synced: 2024-10-16T07:04:53.300Z (21 days ago)
Topics: framework, hacktoberfest, pode, powershell, templates, web
Language: PowerShell
Homepage:
Size: 9.73 MB
Stars: 190
Watchers: 16
Forks: 24
Open Issues: 103
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Roadmap: docs/roadmap.md

Awesome Lists containing this project

README

        
#  Pode.Web

> This is the develop branch for Pode.Web v1.0.0, which is currently dependant on Pode v2.10.1. If you want the latest released Pode.Web code (v0.8.3), please view the master branch instead.

[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/Badgerati/Pode.Web/master/LICENSE.txt)

[![Documentation](https://img.shields.io/github/v/release/badgerati/pode.web?label=docs)](https://badgerati.github.io/Pode.Web)

[![GitHub Actions](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fbadgerati%2Fpode.web%2Fbadge&style=flat&label=GitHub)](https://actions-badge.atrox.dev/badgerati/pode.web/goto)

[![Discord](https://img.shields.io/discord/887398607727255642)](https://discord.gg/fRqeGcbF6h)

[![PowerShell](https://img.shields.io/powershellgallery/dt/pode.web.svg?label=PowerShell&colorB=085298)](https://www.powershellgallery.com/packages/Pode.Web)

[![Docker](https://img.shields.io/docker/pulls/badgerati/pode.web.svg?label=Docker)](https://hub.docker.com/r/badgerati/pode.web/)

[![GitHub Sponsors](https://img.shields.io/github/sponsors/Badgerati?color=%23ff69b4&logo=github&style=flat&label=Sponsers)](https://github.com/sponsors/Badgerati)

[![Ko-fi](https://img.shields.io/static/v1?logo=kofi&label=Ko-fi&logoColor=white&message=Buy+me+a+coffee&color=ff5f5f)](https://ko-fi.com/badgerati)

[![PayPal](https://img.shields.io/static/v1?logo=paypal&label=PayPal&logoColor=white&message=Donate&color=00457C)](https://paypal.me/badgerati)

> 💝 A lot of my free time, evenings, and weekends goes into making Pode happen; please do consider sponsoring as it will really help! 😊

- [📦 Libraries](#-libraries)

- [📘 Documentation](#-documentation)

- [🚀 Features](#-features)

- [📦 Install](#-install)

- [🙌 Contributing](#-contributing)

- [🔥 Quick Example](#-quick-example)

- [🌎 Roadmap](#-roadmap)

This is a web template framework for use with the [Pode](https://github.com/Badgerati/Pode) PowerShell web server (v2.10.1+).

It allows you to build web pages purely with PowerShell - no HTML, CSS, or JavaScript knowledge is required!

You can build charts, forms, tables, general text, tabs, login pages, etc. There's a light, dark, terminal, and more themes available, and you can supply custom CSS files or build your own in PowerShell.

## 📦 Libraries

The Pode.Web templates are built using [Bootstrap](https://getbootstrap.com), [jQuery](https://jquery.com), [Material Design Icons](https://pictogrammers.com/library/mdi/), [Chart.js](https://www.chartjs.org), and [Highlight.js](https://github.com/highlightjs/highlight.js).

## 📘 Documentation

All documentation and tutorials for Pode.Web can be [found here](https://badgerati.github.io/Pode.Web) - this documentation will be for the latest release.

To see the docs for other releases, branches, or tags, you can host the documentation locally. To do so you'll need to have the [`InvokeBuild`](https://github.com/nightroman/Invoke-Build) module installed; then:

```powershell

Invoke-Build Docs

```

Then navigate to `http://127.0.0.1:8000` in your browser.

## 🚀 Features

* Like [Pode](https://github.com/Badgerati/Pode), this is already cross-platform! (with support for PS5)

* Easily add pages, with different elements

* Support for authentication with a login page!

* Create line, bar, pie, and doughnut charts

* Support for forms, with all kinds of input elements

* Show toast messages on the page, or send desktop notifications

* Display data in tables, with pagination, sorting, and filtering

* Use a stepper for a more controlled flow of form input

* Or, use a tabs layout for your pages!

* Show or right code via the Monaco editor (still WIP)

* Render code in code blocks with code highlighting!

* Support for Light, Dark, Terminal, custom themes, and more

## 📦 Install

You can install Pode.Web from the PowerShell Gallery, or via Docker:

```powershell

# powershell gallery

Install-Module -Name Pode.Web

# docker

docker pull badgerati/pode.web

```

## 🙌 Contributing

Pull Requests, Bug Reports and Feature Requests are welcome! Feel free to help out with Issues and Projects!

To build Pode.Web, before running any examples, run the following:

```powershell

Invoke-Build Build

```

To work on issues you can fork Pode.Web, and then open a Pull Request for approval. Pull Requests should be made against the `develop` branch. Each Pull Request should also have an appropriate issue created.

## 🔥 Quick Example

The below will build a web page that shows a chart with the top 10 processes running on your machine, and that auto-refreshes every minute:

```powershell

Import-Module Pode.Web

Start-PodeServer {

    # add a simple endpoint

    Add-PodeEndpoint -Address localhost -Port 8090 -Protocol Http

    # set the use of the pode.web templates

    Use-PodeWebTemplates -Title 'Example' -Theme Midnight

    # add the page

    Add-PodeWebPage -Name Processes -Icon Activity -ScriptBlock {

        New-PodeWebChart -Name 'Top Processes' -Type Bar -AutoRefresh -AsCard -ScriptBlock {

            Get-Process |

                Sort-Object -Property CPU -Descending |

                Select-Object -First 10 |

                ConvertTo-PodeWebChartData -LabelProperty ProcessName -DatasetProperty CPU

        }

    }

}

```

![chart_processes](/images/chart_processes.png)

## 🌎 Roadmap

You can find a list of the features, enhancements, and ideas that will hopefully one day make it into Pode.Web [here in the documentation](https://badgerati.github.io/Pode.Web/roadmap/).

There is also a [Project](https://github.com/users/Badgerati/projects/3) in the beginning of being set up for Pode.Web, with milestone progression and current roadmap issues. Plus, there is a [Draft Board](https://github.com/users/Badgerati/projects/5) that contains a range of ideas for Pode.Web features/enhancements that are either brilliant, ludicrous, or downright insane! Draft Issues are purely ideas, and any in the design stage might one day make it in! If you see a Draft Issue you wish to discuss or have an idea for one, please discuss it over on [Discord](https://discord.gg/fRqeGcbF6h) in the `#ideas` or `#pode-web` channel.