Giter VIP home page Giter VIP logo

sorousheta / web-portal Goto Github PK

View Code? Open in Web Editor NEW

This project forked from enchant97/web-portal

0.0 0.0 0.0 882 KB

Web Portal is a all-in-one web dashboard, providing many widgets to build a personal portal. With the ability to load external plugins.

Home Page: https://enchantedcode.co.uk/web-portal/

License: GNU Affero General Public License v3.0

Shell 0.38% JavaScript 1.65% Python 60.46% CSS 7.36% Dockerfile 0.65% Jinja 29.51%

web-portal's Introduction

Web Portal

GitHub Supported Python Version GitHub release (latest by date including pre-releases)

Web Portal is a all-in-one web dashboard, providing many widgets to build a personal portal. With the ability to load external plugins.

It has been designed to run through docker and it is recommended to put it behind a proxy like Nginx for custom routing and domain names.

If you want just a basic link panel configured with a yaml file checkout Web Portal Lite available here: https://github.com/enchant97/web-portal-lite.

Features

  • Minimal use of Javascript, to provide a lightning fast experience
  • Icon based UI
  • Minimal docker image (if deployed with docker)
  • Adjustable site theme
  • Plugin support
  • Inbuilt Plugin Widgets
    • Core
      • Digital Clock
      • Links
        • Groups
        • Colors
        • Icons
      • Search bar
    • Core-Extras
      • HTML embed
      • Website embed (through iframe)
  • Password protection for admin modification
  • Optionally secure the portal with user accounts & passwords
  • MySQL & SQLite support

Showcase

web-portal showcase image, showing dark and light themes

Demo Video

WIP

Public Demo Instance

There is a public demo instance of Web Portal, kindly hosted by a friend access it here: https://webportal.demo.enchantedcode.co.uk/. Read the following notes:

  • Some features have been disabled to ensure the public instance can be accessed by everyone
  • Resets on a schedule
  • Do not put personal information as it is publicly viewable
  • Server may appear as down, please try again later
  • You may use the 'admin' or 'demo' account

Third-Party Plugins

It is encouraged to extend and build upon this app to make it the ultimate dashboard.

Here are some ideas:

  • Server status widget
  • Home Automation
  • Messages widget (leave messages for users)

You can discuss plugins here.

Branches

Name Description State
main Work ready for release Stable
next Work for next version Very Unstable
historical-X Historical versions Unsupported

Choose a tag/release for most stable if running project

Contributions

Contributing to this project is welcome, whether that is an issue or pull request, but please read the guidelines below:

  • Contributions may get rejected, if they do not fit the project
  • New widgets most likely will not be added, instead make a plugin (feel free to add the idea to the GitHub discussions page, here)
  • You should keep code to this existing style/format
  • Contributions should not require more pip packages from being added, although there may be exceptions
  • Contributions must be licensed under the same as the project
  • Submit pull requests to 'next' branch, please include some details of what the Contribution is
  • Don't change the version number

Documentation

More details and guides on installing can be found at: enchantedcode.co.uk/web-portal/ or view the markdown in the docs folder here.

License

This project is Copyright (c) 2023 Leo Spratt, licences shown below:

Code

AGPL-3 or any later version. Full license found in `LICENSE.txt`

Documentation

FDLv1.3 or any later version. Full license found in `docs/LICENSE.txt`

This project also uses some third party content, licences for those are found at: THIRD-PARTY.txt.

web-portal's People

Contributors

dependabot[bot] avatar enchant97 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.