Dashboard on Producthunt daily

saas-starter

Sat, 23 Aug 2025 15:26:48 +0800

nextjs/saas-starter

Next.js SaaS Starter

This is a starter template for building a SaaS application using Next.js with support for authentication, Stripe integration for payments, and a dashboard for logged-in users.

Demo: https://next-saas-start.vercel.app/

Features

Marketing landing page (/) with animated Terminal element
Pricing page (/pricing) which connects to Stripe Checkout
Dashboard pages with CRUD operations on users/teams
Basic RBAC with Owner and Member roles
Subscription management with Stripe Customer Portal
Email/password authentication with JWTs stored to cookies
Global middleware to protect logged-in routes
Local middleware to protect Server Actions or validate Zod schemas
Activity logging system for any user events

Tech Stack

Framework: Next.js
Database: Postgres
ORM: Drizzle
Payments: Stripe
UI Library: shadcn/ui

Getting Started

1
2
3

git clone https://github.com/nextjs/saas-starter
cd saas-starter
pnpm install

Running Locally

Install and log in to your Stripe account:

`1`	`stripe login`

Use the included setup script to create your .env file:

`1`	`pnpm db:setup`

Run the database migrations and seed the database with a default user and team:

1
2

pnpm db:migrate
pnpm db:seed

This will create the following user and team:

User: test@test.com
Password: admin123

You can also create new users through the /sign-up route.

Finally, run the Next.js development server:

`1`	`pnpm dev`

Open http://localhost:3000 in your browser to see the app in action.

You can listen for Stripe webhooks locally through their CLI to handle subscription change events:

`1`	`stripe listen --forward-to localhost:3000/api/stripe/webhook`

Testing Payments

To test Stripe payments, use the following test card details:

Card Number: 4242 4242 4242 4242
Expiration: Any future date
CVC: Any 3-digit number

Going to Production

When you’re ready to deploy your SaaS application to production, follow these steps:

Set up a production Stripe webhook

Go to the Stripe Dashboard and create a new webhook for your production environment.
Set the endpoint URL to your production API route (e.g., https://yourdomain.com/api/stripe/webhook).
Select the events you want to listen for (e.g., checkout.session.completed, customer.subscription.updated).

Deploy to Vercel

Push your code to a GitHub repository.
Connect your repository to Vercel and deploy it.
Follow the Vercel deployment process, which will guide you through setting up your project.

Add environment variables

In your Vercel project settings (or during deployment), add all the necessary environment variables. Make sure to update the values for the production environment, including:

BASE_URL: Set this to your production domain.
STRIPE_SECRET_KEY: Use your Stripe secret key for the production environment.
STRIPE_WEBHOOK_SECRET: Use the webhook secret from the production webhook you created in step 1.
POSTGRES_URL: Set this to your production database URL.
AUTH_SECRET: Set this to a random string. openssl rand -base64 32 will generate one.

Other Templates

While this template is intentionally minimal and to be used as a learning resource, there are other paid versions in the community which are more full-featured:

dataease

Sun, 27 Jul 2025 15:29:46 +0800

dataease/dataease

人人可用的开源 BI 工具

什么是 DataEase？

DataEase 是开源的 BI 工具，帮助用户快速分析数据并洞察业务趋势，从而实现业务的改进与优化。DataEase 支持丰富的数据源连接，能够通过拖拉拽方式快速制作图表，并可以方便的与他人分享。

DataEase 的优势：

开源开放：零门槛，线上快速获取和安装，按月迭代；
简单易用：极易上手，通过鼠标点击和拖拽即可完成分析；
全场景支持：多平台安装和多样化嵌入支持；
安全分享：支持多种数据分享方式，确保数据安全。

DataEase 支持的数据源：

OLTP 数据库： MySQL、Oracle、SQL Server、PostgreSQL、MariaDB、Db2、TiDB、MongoDB-BI 等；
OLAP 数据库： ClickHouse、Apache Doris、Apache Impala、StarRocks 等；
数据仓库/数据湖： Amazon RedShift 等；
数据文件： Excel、CSV 等；
API 数据源。

如果您需要向团队介绍 DataEase，可以使用这个官方 PPT 材料。

快速开始

桌面版：

你可以在 PC 上安装 DataEasae 桌面版，下载地址为：https://dataease.cn/desktop/index.html

服务器版：

# 准备一台 2 核 4G 以上的 Linux 服务器，并以 root 用户运行以下一键安装脚本：

curl -sSL https://dataease.oss-cn-hangzhou.aliyuncs.com/quick_start_v2.sh | bash

# 用户名: admin
# 密码: DataEase@123456

你也可以通过 1Panel 应用商店快速部署 DataEase。如果是用于生产环境，推荐使用离线安装包方式进行安装部署。

如你有更多问题，可以查看在线文档，或者通过论坛与我们交流。

UI 展示

技术栈

前端：Vue.js、Element
图库：AntV
后端：Spring Boot
数据库：MySQL
数据处理：Apache Calcite、Apache SeaTunnel
基础设施：Docker

飞致云的其他明星项目

1Panel - 现代化、开源的 Linux 服务器运维管理面板
MaxKB - 基于 LLM 大语言模型的开源知识库问答系统
JumpServer - 广受欢迎的开源堡垒机
Halo - 强大易用的开源建站工具
MeterSphere - 新一代的开源持续测试工具

License

Licensed under The GNU General Public License version 3 (GPLv3) (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.gnu.org/licenses/gpl-3.0.html

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

dashy

Tue, 22 Jul 2025 15:33:52 +0800

Lissy93/dashy

Dashy

Dashy helps you organize your self-hosted services by making them accessible from a single place

User Showcase | Live Demo | Getting Started | Documentation | GitHub

^{Dashy is kindly sponsored by Umbrel - the personal home cloud and OS for self-hosting}

[!NOTE] Version 3.0.0 has been released, and requires some changes to your setup, see #1529 for details.

Table of Contents

Features 🌈

📃 Support for multiple pages
🚦 Real-time status monitoring for each of your apps/links
📊 Use widgets to display info and dynamic content from self-hosted services
🔎 Instant search by name, domain, or tags + customizable hotkeys & keyboard shortcuts
🎨 Many built-in color themes, with UI color editor and support for custom CSS
🧸 Many icon options - Font-Awesome, homelab icons, auto-fetching Favicon, images, emojis, etc.
💂 Optional authentication with multi-user access, configurable privileges, and SSO support
🌎 Multi-language support, with 10+ human-translated languages, and more on the way
☁ Optional, encrypted, free off-site cloud backup and restore feature available
💼 A workspace view, for easily switching between multiple apps simultaneously
🛩️ A minimal view, for use as a fast-loading browser Startpage
🖱️ Choose app launch methods: new tab, same tab, clipboard, pop-up modal, or open in workspace view
📏 Customizable layout, sizes, text, component visibility, sort order, behavior, etc.
🖼️ Options for a full-screen background image, custom nav-bar links, HTML footer, title, etc.
🚀 Easy to setup with Docker, or on bare metal, or with 1-Click cloud deployment
⚙️ Easy single-file YAML-based configuration, and option to configure app through the UI
✨ Under active development with improvements and new features added regularly
🤏 Small bundle size, fully responsive UI, and PWA for basic offline access
🆓 100% free and open-source
🔐 Strong focus on privacy
🌈 And loads more…

⬆️ Back to Top

Demo ⚡

Live Instances: Demo 1 (Live Demo) ┆ Demo 2 (Dashy Links) ┆ Demo 3 (Dev Preview)

Screenshots: Checkout the Showcase, to see example dashboards from the community

Spin up your own demo: [

⬆️ Back to Top

Getting Started 🚀

For full setup instructions, see: Deployment

Deploying from Docker Hub 🐳

You will need Docker installed on your system

`1`	`docker run -p 8080:8080 lissy93/dashy`

docker run -d \
  -p 4000:8080 \
  -v /root/my-local-conf.yml:/app/user-data/conf.yml \
  --name my-dashboard \
  --restart=always \
  lissy93/dashy:latest

See also: examples with Docker Compose. Dashy is also available via GHCR, and tags for other architectures (arm32v7, arm64v8, etc.) and set versions are supported

Once you’ve got Dashy running, see App Management Docs for info on using health checks, updating, backups, web-server configs, logs, performance, security, and more.

Deploying from Source 🔨

You will need git, the latest or LTS version of Node.js and (optionally) Yarn installed on your system.

Clone the Repo: git clone https://github.com/Lissy93/dashy.git and cd dashy
Configuration: Fill in your settings in ./user-data/conf.yml
Install dependencies: yarn
Build: yarn build
Run: yarn start

See docs: Full list of Dashy’s commands

Deploy to the Cloud ☁️

Dashy supports 1-Click deployments on several popular cloud platforms. To spin up a new instance, just click a link below:

For more 1-click cloud deployments, see Cloud Deployment

⬆️ Back to Top

Configuring 🔧

For full configuration documentation, see: Configuring

Dashy is configured through a YAML file, located at ./user-data/conf.yml. In addition, you can find a complete list of available options in the Configuring Docs. The config can also be edited and saved directly through the UI.

⬆️ Back to Top

Theming 🎨

For full theming documentation, see: Theming

Dashy comes pre-bundled with several built-in themes, which you can preview, apply and edit through the UI. With the theme configurator and support for custom CSS, everything is in place to quickly develop your own unique-looking dashboard.

⬆️ Back to Top

Icons 🧸

For full iconography documentation, see: Icons

Both sections and items can have an icon associated with them, defined under the icon attribute. With several different icon packs supported, you’ll be able to find the perfect thumbnail for any app or service.

The following icon types are supported:

Favicon - Automatically fetch an apps icon from its Favicon or logo image
Icon Packs - Use any icon from font-awesome, simple-icons, selfh.st/icons, or material icons
Emoji - Any valid emoji can be used as an icon
Generative - Unique, auto-generated images for easily identifying services
URL - Pass the URL of any valid image in to have it fetched and rendered
Local - Store custom images locally and reference by filename
Homelab Icons - Using dashboard-icons for logos of commonly self-hosted services

⬆️ Back to Top

Status Indicators 🚦

For full monitoring documentation, see: Status Indicators

Dashy has an optional feature to check if each app/ service is up and responding, then display a small status indicator icon. Hovering over it will show additional stats like response time and status code.

Status indicators can be globally enabled by setting appConfig.statusCheck: true or enabled/ disabled on a per-item basis. Status is checked on page load, but you can allow continuous polling by specifying a time interval between checks, in seconds under appConfig.statusCheckInterval. You can also use a different endpoint for status checking, with statusCheckUrl, and if needed, pass in custom headers under statusCheckHeaders.

⬆️ Back to Top

Widgets 📊

For full widget documentation, see: Widgets

You can display dynamic content from services in the form of widgets. There are several pre-built widgets available for showing useful info, and integrations with commonly self-hosted services, but you can also easily create your own for almost any app.

⬆️ Back to Top

Authentication 🔐

For full authentication documentation, see: Authentication

Dashy has full support for secure single-sign-on using Keycloak for secure, easy authentication, see setup docs for a full usage guide.

There is also a basic auth feature, which doesn’t require additional setup. To enable this, add an auth attribute under appConfig, containing an array of users, each with a username, SHA-256 hashed password and optional user type. Basic auth also supports several access control features, including read-only guest access and granular controls.

appConfig:
  auth:
    users:
    - user: alicia
      hash: 4D1E58C90B3B94BCAD9848ECCACD6D2A8C9FBC5CA913304BBA5CDEAB36FEEFA3
      type: admin

Other access control systems are also supported, see the Alternative Auth Methods docs.

⬆️ Back to Top

Alternate Views 👓

As well as the default homepage, there is also:

A minimal view, valid for use as a browser start page
A workspace view, useful for visiting many apps simultaneously

You can change the view from the UI, using the switch icon in the top-right corner, or select a default view in the config under appConfig.startingView attribute.

Example of Workspace View

Example of Minimal View

⬆️ Back to Top

Opening Methods 🖱️

For full documentation on views and opening methods, see: Alternate Views

There are several different ways you can launch apps. You can specify the default opening method for any given item under the target attribute or set a site-wide default under appConfig.defaultOpeningMethod. Right-click on an item to item for all options. The following options are supported:

sametab - The app will be launched in the current tab
newtab - The app will be launched in a new tab (or use Ctrl + Click)
modal - Launch app in a resizable/ movable popup modal on the current page (or use Alt + Click)
workspace - Changes to Workspace view and launches app
clipboard - Copy the app’s URL to your system clipboard
top - Opens in the top-most browsing context, useful if you’re accessing Dashy through an iframe

⬆️ Back to Top

Searching and Shortcuts 🔎

For full documentation on searching, see: Searching & Shortcuts

Quickly finding and launching applications is the primary aim of Dashy. To that end, instant search and customizable keyboard shortcuts are built-in.

To start filtering, start typing—no need to select the search bar or use any special key. Then use either the tab key or arrow keys to select and move between results, and hit enter to launch the currently selected application.

For apps that you use regularly, you can set a custom keybinding. Use the hotkey parameter on a certain item to specify a numeric key between 0 - 9. You can then launch that app by just pressing that key.

You can also add custom tags to a given item to make finding them based on keywords easier. For example, in the following example, searching for ‘Movies’ will show ‘Plex’

  items:
  - title: Plex
    hotkey: 8
    icon: favicon
    description: Media library
    url: https://plex.lab.local
    tags: [ movies, videos, music ]

To search the web directly through Dashy, just press enter after typing your query. Options for web search are set under appConfig.webSearch. There is built-in support for 10+ search engines, or use your own custom provider or self-hosted instance. With the web search, you can also define your bangs to redirect results to any given app, website, or search engine, when the query is preceded with a certain character sequence (usually beginning in /, ! or :).

webSearch:
  searchEngine: duckduckgo
  openingMethod: newtab
  searchBangs:
    /r: reddit
    /w: wikipedia
    /s: https://whoogle.local/search?q=
    ':wolf': wolframalpha
    ':so': stackoverflow
    ':git': github

Hit Esc at any time to close any open apps, clear the search field, or hide any modals.

⬆️ Back to Top

Config Editor ⚙️

For full config documentation, see: Configuring

As well as passing in a YAML config file, you can also configure the app directly through the UI and preview changes live.

To edit any section or item, right-click on it, and select “Edit”, or enter the Edit Mode (using the Pen icon in the top-right), then click any part of the page to edit. Changes will be visible immediately but will not be saved until clicking “Save to Disk” or “Save Locally”.

Under the config menu, you can export, view, backup, or reset app config and edit the raw config file in a text editor with built-in schema validation. It’s recommended to keep a backup of your config.

⬆️ Back to Top

Cloud Backup & Sync ☁

For full backup documentation, see: Cloud Backup & Sync

Dashy has an optional built-in feature for securely backing up your config to a hosted cloud service and then restoring it on another instance. This is useful not only for backing up your configuration off-site but also enables Dashy to be used without having to write a YAML config file.

All data is fully E2E encrypted before being sent to the backend (done in CloudBackup.js using crypto.js ’s AES method). The data is then sent to a Cloudflare worker and stored in a KV data store.

⬆️ Back to Top

Language Switching 🌎

For full internationalization documentation, see: Multi-Language Support

Dashy supports multiple languages and locales. When available, your language should be automatically detected and applied on load. But you can also select a language through the UI (under config –> Switch Language) or set appConfig.language to your language (specified as a 2-digit ISO 639-1 code), as seen below, e.g. language: de.

Supported Languages

🇬🇧 English: en - Default
🇦🇪 Arabic: ar - Auto-generated
🇧🇩 Bengali: bn - Contributed by @soaibsafi
🇧🇬 Bulgarian: bg - Contributed by @asenov
🇨🇳 Chinese: cn - Contributed by @FormatToday
🇨🇿 Czech: cs - Contributed by @Tuzi555
🇩🇰 Danish: da - Contributed by @lordpansar
🇳🇱 Dutch: nl - Contributed by @evroon
🇫🇷 French: fr - Contributed by @EVOTk
🇩🇪 German: de - Contributed by @Niklashere
🇬🇷 Greek: el - Contributed by @aviolaris
🇮🇳 Hindi: hi - Auto-generated
🇮🇹 Italian: it - Contributed by @alexdelprete
🇯🇵 Japanese: ja - Auto-generated
🇰🇷 Korean: ko - Contributed by @boggy-cs
🇳🇴 Norwegian Bokmål: nb - Contributed by @rubjo
🇵🇱 Polish: pl - Contributed by @skaarj1989
🇵🇹 Portuguese: pt - Contributed by @LeoColman
🛰️ Galician: gl - Contributed by @pvillaverde
🇷🇺 Russian: ru -Contributed by @sasetz
🇸🇰 Slovak: sk - Contributed by @Smexhy
🇸🇮 Slovenian: sl - Contributed by @UrekD
🇪🇸 Spanish: es - Contributed by @lu4t
🇸🇪 Swedish: sv - Contributed by @BOZG
🇹🇼 Traditional Chinese: zh-TW - Contributed by @stanly0726
🇹🇷 Turkish: tr - Contributed by @imsakg
🇺🇦 Ukrainian: uk - Contributed by @allozavrr
🏴‍☠️ Pirate: pirate - Contributed by @Lissy93

Add your Language

I would love Dashy to be available to everyone without language being a barrier to entry. If you’ve got a few minutes to spare, consider adding translations for your language. It’s a quick task, and all text is in a single JSON file. Since any missing text will fall back to English, you don’t need to translate it all.

⬆️ Back to Top

Multi-Page Support 📃

For full multi-page documentation, see: Pages & Sections

Within your dashboard, you can have as many sub-pages as you require. To load additional pages, specify a name, and path to a config file under pages. The config file can be either local (stored in /public), or remote (located anywhere accessible).

pages:
- name: Networking Services
  path: 'networking.yml'
- name: Work Stuff
  path: 'work.yml'

pages:
- name: Getting Started
  path: 'https://snippet.host/tvcw/raw'
- name: Homelab
  path: 'https://snippet.host/tetp/raw'
- name: Browser Startpage
  path: 'https://snippet.host/zcom/raw'

System Requirements 📊

If running on bare metal, Dashy requires Node V 16.0.0 or later, LTS (16.13.2) is recommended.

If running in Docker container, the recommended base image is Alpine (3.15)

The hardware requirements vary depending on where and how you are running Dashy. Generally speaking, on a bare-metal system or Docker container, 1GB of memory should be more than enough, and depending on whether you are using your own assets, then 1GB of disk space should be sufficient.

If you are using one of the 1-click cloud deployment methods, serving the app through a CDN or using a static hosting provider, then there are no specific requirements, as the built app is just a series of static JS files, and so is very light-weight.

Dashy also wells run on low-powered ARM-based single board computers, such as a Raspberry Pi (tested on Pi 3)

Browser Support


Latest ✔	Latest ✔	10+ ✔	Latest ✔	6.1+ ❌

⬆️ Back to Top

Support 🙋‍♀️

If you’re having trouble getting Dashy up and running, or have a question about usage or configuration, feel free to ask. The best place to do this is via the Discussions.

If you’ve found something which isn’t working as it should, please raise a bug by opening a ticket.

It’s best to check the docs, previous issues and troubleshooting guide first.

⬆️ Back to Top

Supporting Dashy 💖

For full details and other ways you can help out, see: Contributing

If you’re using Dashy and would like to help support its development, then that would be awesome! Contributions of any type, any size, are always very much appreciated, and we will appropriately credit you for your effort.

Several areas that we need a bit of help with at the moment are:

Translating - Help make Dashy available to non-native English speakers by adding your language
Donate a small amount by Sponsoring @Lissy93 on GitHub and receive some extra perks!
Complete a short survey to have your say about future features
Share your dashboard in the Showcase, to inspire others
Spread the word by sharing Dashy or a screenshot of your dashboard to help new users discover it
Submit a PR to add a new feature, fix a bug, update the docs, add a theme, widget or something else
Star Dashy on GitHub/ DockerHub or leave an upvote / review on these platforms

⬆️ Back to Top

Credits 🏆

For a complete list of credits, and attributions to packages used within Dashy, see: Credits

Thank you so much to everyone who has helped with Dashy so far; every contribution is very much appreciated.

Contributors

[

Stats

⬆️ Back to Top

Developing 🧱

For full development documentation, see: Developing

Before getting started, you’ll need Git, Node and optionally Yarn (run npm i -g yarn) installed.

To set up the development environment:

Get Code: git clone https://github.com/Lissy93/dashy.git and cd dashy
Install dependencies: yarn
Start dev server: yarn dev
Open the browser: http://localhost:8080

When you’re ready, you can build the production app with yarn build, and then run it with yarn start

If you’re new to web development, I’ve put together a short list of resources to help beginners get started

Repo Status:

⬆️ Back to Top

Documentation 📘

For full docs, see: Documentation Contents

Running Dashy

💨 Quick Start - TDLR guide on getting Dashy up and running in under 5 minutes
🚀 Deployment - Full guide on setting up Dashy on various different environments
🔧 Configuring - Complete list of all available options in the config file
💻 Management - Managing your app, updating, security, web server configuration, etc
🚒 Troubleshooting - Common errors and problems, and how to fix them

Feature Docs

🛡️ Authentication - Guide to setting up authentication to protect your dashboard
🌈 Alternate Views - Outline of available pages / views and item opening methods
💾 Backup & Restore - Guide to backing up config with Dashy’s cloud sync feature
🧸 Icons - Outline of all available icon types for sections and items, with examples
🌐 Multi-Language Support - Switching languages, and adding a new locales
🚦 Status Indicators - Using Dashy to monitor uptime and status of your apps
🔍 Searching & Shortcuts - Searching, launching methods + keyboard shortcuts
🎨 Theming - Complete guide to applying, writing and modifying themes + styles
📊 Widgets - List of all dynamic content widgets, with usage guides and examples

Development and Contributing

🧱 Developing - Running Dashy development server locally, and general workflow
🛎️ Development Guides - Common development tasks, to help new contributors
💖 Contributing - How to contribute to Dashy
🌟 Showcase - See how others are using Dashy, and share your dashboard
🏆 Credits - Shout out to the amazing people who have contributed so far
🗞️ Release Workflow - Info about releases, CI and automated tasks

Misc

🔐 Privacy & Security - List of requests, potential issues, and security resources
📄 License - Copy of the MIT License
⚖️ Legal - Licenses of direct dependencies
📏 Code of Conduct - Contributor Covenant Code of Conduct
🌳 Changelog - Details of recent changes, and historical versions

⬆️ Back to Top

Roadmap 🛣️

For upcoming features that will be released in the near future, see the Current Roadmap

For past updates, see the Changelog

⬆️ Back to Top

Alternatives 🙌

A few self-hosted web apps serve a similar purpose to Dashy. If you’re looking for a dashboard, and Dashy doesn’t meet your needs, I highly recommend you check these projects out!

Flame by @pawelmalak (MIT)
HomeDash2
Homer (Apache License 2.0)
Organizr (GPL-3.0 License)
Heimdall (MIT)
Smashing (MIT)
See more 👉 Awesome Self-Hosted

⬆️ Back to Top

License 📜

Dashy is Licensed under MIT X11

Copyright © 2021-2024 Alicia Sykes <https://aliciasykes.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of this
software and associated documentation files (the "Software"), to deal in the Software
without restriction, including without limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of the Software, and to permit
persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or
substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE
OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, Dashy shall not be used in advertising or otherwise
to promote the sale, use, or other dealings in this Software without prior written
authorization from the repo owner.

TDLR; You can do whatever you like with Dashy: use it in private or commercial settings, redistribute and modify it. But you must display this license and credit the author. There is no warranty that this app will work as expected, and the author cannot be held liable for anything that goes wrong. For more info, see TLDR Legal’s Explanation of MIT

⬆️ Back to Top

© Alicia Sykes 2024
Licensed under MIT

^{Thanks for visiting :)}

AdminLTE

Wed, 02 Jul 2025 15:29:57 +0800

ColorlibHQ/AdminLTE

AdminLTE - Bootstrap 5 Admin Dashboard

AdminLTE is a fully responsive administration template. Based on Bootstrap 5 framework and also the JavaScript plugins. Highly customizable and easy to use. Fits many screen resolutions from small mobile devices to large desktops.

What’s New in v4.0.0-rc3

Production Deployment & Cross-Platform Compatibility - This release resolves critical production deployment issues:

Fixed Production Builds - Resolved CSS/JS path issues, sidebar navigation, and image loading in all deployment scenarios
Smart Path Resolution - Automatic relative path calculation works for root deployment, sub-folders, and CDN hosting
RTL CSS Fix - Eliminated rtlcss interference with standard LTR production builds
Updated Dependencies - Bootstrap 5.3.7, Bootstrap Icons 1.13.1, OverlayScrollbars 2.11.0
Zero Console Errors - Fixed all CDN integrity mismatches and runtime issues
FTP/Static Host Ready - Perfect compatibility with traditional hosting and modern static platforms

Key Improvements:

✅ Development and production environments now behave identically
✅ Images, CSS, and JavaScript load correctly in any deployment structure
✅ Sidebar navigation displays properly with badges and arrow indicators
✅ All CDN resources load without console errors
✅ Complete production build included in repository for easy deployment

See the CHANGELOG.md for complete details.

Looking for Premium Templates?

AdminLTE.io just opened a new premium templates page. Hand picked to ensure the best quality and the most affordable prices. Visit https://adminlte.io/premium for more information.

AdminLTE has been carefully coded with clear comments in all of its JS, SCSS and HTML files. SCSS has been used to increase code customizability.

Quick start

Development

To start developing with AdminLTE:

Install dependencies: npm install
Start development server: npm start (opens browser at http://localhost:3000)
Start coding! Files auto-compile and refresh on changes

Production Build

To build for production:

Full production build: npm run production (includes linting and optimization)
Quick build: npm run build (faster for development/testing)

Available Scripts

npm start - Start development server with file watching
npm run build - Build all assets for development
npm run production - Full production build with linting and bundlewatch
npm run lint - Run all linters (JS, CSS, docs, lockfile)
npm run css - Build CSS only
npm run js - Build JavaScript only

Browser Support

AdminLTE supports all modern browsers with the latest Bootstrap 5.3.7:

Chrome (latest)
Firefox (latest)
Safari (latest)
Edge (latest)

Contributing

Highly welcome.
For your extra reference check AdminLTE v4 Contribution Guide
First thing first, you should have bit knowledge about NodeJS.
Github Knowledge.
Install NodeJS LTS version.
Clone this Repository to your machine and change to master branch.
Go to Cloned Folder.
In cli/bash run npm install it will install dependency from package.json.
After installation completes, run npm start
Cool, Send your changes in PR to master branch.

Sponsorship

Support AdminLTE development by becoming a sponsor. Github Sponsors or PayPal

License

AdminLTE is an open source project by AdminLTE.io that is licensed under MIT. AdminLTE.io reserves the right to change the license of future releases.

Image Credits

f1-dash

Tue, 27 May 2025 15:31:25 +0800

slowlydev/f1-dash

Real-time Formula 1 telemetry and timing

f1-dash

A real-time F1 dashboard that shows the leader board, tires, gaps, laps, mini sectors and much more.

Contributing

I really appreciate your interest in contributing to this project. I recommend checking out the GitHub issues marked as “Good First Issue” to get started. Also, please read CONTRIBUTING.md to learn how to contribute and set up f1-dash on your local machine for development.

Supporting

If you’d like to support this project and help me dedicate more time to it, you can buy me a coffee.

Notice

This project/website is unofficial and is not associated in any way with the Formula 1 companies. F1, FORMULA ONE, FORMULA 1, FIA FORMULA ONE WORLD CHAMPIONSHIP, GRAND PRIX and related marks are trade marks of Formula One Licensing B.V.

glance

Wed, 07 May 2025 15:29:28 +0800

glanceapp/glance

What if you could see everything at a...

Glance

Install • Configuration • Discord • Sponsor

Community widgets • Preconfigured pages • Themes

Features

Various widgets

RSS feeds
Subreddit posts
Hacker News posts
Weather forecasts
YouTube channel uploads
Twitch channels
Market prices
Docker containers status
Server stats
Custom widgets
and many more…

Fast and lightweight

Low memory usage
Few dependencies
Minimal vanilla JS
Single <20mb binary available for multiple OSs & architectures and just as small Docker container
Uncached pages usually load within ~1s (depending on internet speed and number of widgets)

Tons of customizability

Different layouts
As many pages/tabs as you need
Numerous configuration options for each widget
Multiple styles for some widgets
Custom CSS

Optimized for mobile devices

Because you’ll want to take it with you on the go.

Themeable

Easily create your own theme by tweaking a few numbers or choose from one of the already available themes.

Configuration

Configuration is done through YAML files, to learn more about how the layout works, how to add more pages and how to configure widgets, visit the configuration documentation.

Preview example configuration file

pages:
  - name: Home
    columns:
      - size: small
        widgets:
          - type: calendar
            first-day-of-week: monday

          - type: rss
            limit: 10
            collapse-after: 3
            cache: 12h
            feeds:
              - url: https://selfh.st/rss/
                title: selfh.st
                limit: 4
              - url: https://ciechanow.ski/atom.xml
              - url: https://www.joshwcomeau.com/rss.xml
                title: Josh Comeau
              - url: https://samwho.dev/rss.xml
              - url: https://ishadeed.com/feed.xml
                title: Ahmad Shadeed

          - type: twitch-channels
            channels:
              - theprimeagen
              - j_blow
              - piratesoftware
              - cohhcarnage
              - christitustech
              - EJ_SA

      - size: full
        widgets:
          - type: group
            widgets:
              - type: hacker-news
              - type: lobsters

          - type: videos
            channels:
              - UCXuqSBlHAE6Xw-yeJA0Tunw # Linus Tech Tips
              - UCR-DXc1voovS8nhAvccRZhg # Jeff Geerling
              - UCsBjURrPoezykLs9EqgamOA # Fireship
              - UCBJycsmduvYEL83R_U4JriQ # Marques Brownlee
              - UCHnyfMqiRRG1u-2MsSQLbXA # Veritasium

          - type: group
            widgets:
              - type: reddit
                subreddit: technology
                show-thumbnails: true
              - type: reddit
                subreddit: selfhosted
                show-thumbnails: true

      - size: small
        widgets:
          - type: weather
            location: London, United Kingdom
            units: metric
            hour-format: 12h

          - type: markets
            markets:
              - symbol: SPY
                name: S&P 500
              - symbol: BTC-USD
                name: Bitcoin
              - symbol: NVDA
                name: NVIDIA
              - symbol: AAPL
                name: Apple
              - symbol: MSFT
                name: Microsoft

          - type: releases
            cache: 1d
            repositories:
              - glanceapp/glance
              - go-gitea/gitea
              - immich-app/immich
              - syncthing/syncthing

Installation

Choose one of the following methods:

Docker compose using provided directory structure (recommended)

Create a new directory called glance as well as the template files within it by running:

`1`	`mkdir glance && cd glance && curl -sL https://github.com/glanceapp/docker-compose-template/archive/refs/heads/main.tar.gz \| tar -xzf - --strip-components 2`

click here to view the files that will be created

Then, edit the following files as desired:

docker-compose.yml to configure the port, volumes and other containery things
config/home.yml to configure the widgets or layout of the home page
config/glance.yml if you want to change the theme or add more pages

Other files you may want to edit

.env to configure environment variables that will be available inside configuration files
assets/user.css to add custom CSS

When ready, run:

`1`	`docker compose up -d`

If you encounter any issues, you can check the logs by running:

`1`	`docker compose logs`

Docker compose manual

Create a docker-compose.yml file with the following contents:

services:
  glance:
    container_name: glance
    image: glanceapp/glance
    restart: unless-stopped
    volumes:
      - ./config:/app/config
    ports:
      - 8080:8080

Then, create a new directory called config and download the example starting glance.yml file into it by running:

`1`	`mkdir config && wget -O config/glance.yml https://raw.githubusercontent.com/glanceapp/glance/refs/heads/main/docs/glance.yml`

Feel free to edit the glance.yml file to your liking, and when ready run:

`1`	`docker compose up -d`

If you encounter any issues, you can check the logs by running:

`1`	`docker logs glance`

Manual binary installation

Precompiled binaries are available for Linux, Windows and macOS (x86, x86_64, ARM and ARM64 architectures).

Linux

Visit the latest release page for available binaries. You can place the binary in /opt/glance/ and have it start with your server via a systemd service. By default, when running the binary, it will look for a glance.yml file in the directory it’s placed in. To specify a different path for the config file, use the --config option:

`1`	`/opt/glance/glance --config /etc/glance.yml`

To grab a starting template for the config file, run:

`1`	`wget https://raw.githubusercontent.com/glanceapp/glance/refs/heads/main/docs/glance.yml`

Windows

Download and extract the executable from the latest release (most likely the file called glance-windows-amd64.zip if you’re on a 64-bit system) and place it in a folder of your choice. Then, create a new text file called glance.yml in the same folder and paste the content from here in it. You should then be able to run the executable and access the dashboard by visiting http://localhost:8080 in your browser.

Other

Glance can also be installed through the following 3rd party channels:

Common issues

Requests timing out

The most common cause of this is when using Pi-Hole, AdGuard Home or other ad-blocking DNS services, which by default have a fairly low rate limit. Depending on the number of widgets you have in a single page, this limit can very easily be exceeded. To fix this, increase the rate limit in the settings of your DNS service.

If using Podman, in some rare cases the timeout can be caused by an unknown issue, in which case it may be resolved by adding the following to the bottom of your docker-compose.yml file:

1
2
3

networks:
  podman:
    external: true

Broken layout for markets, bookmarks or other widgets

This is almost always caused by the browser extension Dark Reader. To fix this, disable dark mode for the domain where Glance is hosted.

cannot unmarshal !!map into []glance.page

The most common cause of this is having a pages key in your glance.yml and then also having a pages key inside one of your included pages. To fix this, remove the pages key from the top of your included pages.

FAQ

Does the information on the page update automatically?

No, a page refresh is required to update the information. Some things do dynamically update where it makes sense, like the clock widget and the relative time showing how long ago something happened.

How frequently do widgets update?

No requests are made periodically in the background, information is only fetched upon loading the page and then cached. The default cache lifetime is different for each widget and can be configured.

Can I create my own widgets?

Yes, there are multiple ways to create custom widgets:

iframe widget - allows you to embed things from other websites
html widget - allows you to insert your own static HTML
extension widget - fetch HTML from a URL
custom-api widget - fetch JSON from a URL and render it using custom HTML

Can I change the title of a widget?

Yes, the title of all widgets can be changed by specifying the title property in the widget’s configuration:

- type: rss
  title: My custom title

- type: markets
  title: My custom title

- type: videos
  title: My custom title

# and so on for all widgets...

Feature requests

New feature suggestions are always welcome and will be considered, though please keep in mind that some of them may be out of scope for what the project is trying to achieve (or is reasonably capable of). If you have an idea for a new feature and would like to share it, you can do so here.

Feature requests are tagged with one of the following:

Roadmap - will be implemented in a future release
Backlog - may be implemented in the future but needs further feedback or interest from the community
Icebox - no plans to implement as it doesn’t currently align with the project’s goals or capabilities, may be revised at a later date

Building from source

Choose one of the following methods:

Build binary with Go

Requirements: Go >= v1.23

To build the project for your current OS and architecture, run:

`1`	`go build -o build/glance .`

To build for a specific OS and architecture, run:

`1`	`GOOS=linux GOARCH=amd64 go build -o build/glance .`

click here for a full list of GOOS and GOARCH combinations

Alternatively, if you just want to run the app without creating a binary, like when you’re testing out changes, you can run:

`1`	`go run .`

Build project and Docker image with Docker

Requirements: Docker

To build the project and image using just Docker, run:

(replace owner with your name or organization)

`1`	`docker build -t owner/glance:latest .`

If you wish to push the image to a registry (by default Docker Hub), run:

`1`	`docker push owner/glance:latest`

Contributing guidelines

Before working on a new feature it’s preferable to submit a feature request first and state that you’d like to implement it yourself
Please don’t submit PRs for feature requests that are either in the roadmap^[1], backlog^[2] or icebox^[3]
Use dev for the base branch if you’re adding new features or fixing bugs, otherwise use main
Avoid introducing new dependencies
Avoid making backwards-incompatible configuration changes
Avoid introducing new colors or hard-coding colors, use the standard primary, positive and negative
For icons, try to use heroicons where applicable
Provide a screenshot of the changes if UI related where possible
No package.json

^{[1] [2] [3]}

[1] The feature likely already has work put into it that may conflict with your implementation

[2] The demand, implementation or functionality for this feature is not yet clear

[3] No plans to add this feature for the time being

Thank you

To all the people who were generous enough to sponsor the project and to everyone who has contributed in any way, be it PRs, submitting issues, helping others in the discussions or Discord server, creating guides and tools or just mentioning Glance on social media. Your support is greatly appreciated and helps keep the project going.

_{Vincent Koc}	_{Brian Curliss}	_{Anand Chowdhary}	_{Zach Biles}	_{Ulises Gascón}	_InDieTasten
_Araguaci	_{Brian McGonagill}	_Vlad	_HeliXZz	_{Göksel Yeşiller}	_Undefined
_{HamburgerJung}	_Frankdez93	_{Hudsonrock-partnerships}	_{Gl0bal01 💖 龴ↀ◡ↀ龴}