Introduction
LesliAdmin is the official account and application administration engine for the Lesli Framework.
It gives account owners and administrators a central interface for maintaining the core account identity, inspecting application configuration, and understanding the engines installed in a Lesli application.
Features
- Core account name and email management
- Framework configuration overview
- Installed-engine inventory and metadata
- Account-scoped data structures for details, locations, settings, and currencies
- Optional dashboard components through LesliDashboard
Try LesliAdmin
Quick Start
Requirements
- A Rails application with Lesli 5.1
- SQLite by default, or PostgreSQL when preferred by the host application
Install LesliAdmin
Add the engine to the host Rails application and prepare its database:
bundle add lesli_admin
bin/rails lesli:db:prepareMount the engine
Applications using Lesli's standard router mount LesliAdmin automatically at /admin:
# config/routes.rb
Rails.application.routes.draw do
Lesli::Router.mount(self)
endIf the application does not use the standard Lesli router, mount the engine directly:
# config/routes.rb
Rails.application.routes.draw do
mount LesliAdmin::Engine => "/admin"
endStart Rails and visit http://127.0.0.1:3000/admin:
bin/rails routes -g admin
bin/rails serverInstall LesliDashboard when the application should render LesliAdmin's shared dashboard and installed-engines component.
Development
Clone LesliAdmin into the host application's engines directory:
cd RailsApp
mkdir -p engines
git clone https://github.com/LesliTech/LesliAdmin.git engines/LesliAdminReference the local engine from the host application's Gemfile:
gem "lesli_admin", path: "engines/LesliAdmin"Install dependencies, prepare the host database, and start Rails:
bundle install
bin/rails lesli:db:prepare
bin/rails serverTests
From a complete Lesli development workspace, run the engine test suite from the LesliAdmin directory:
cd engines/LesliAdmin
bin/rails testDocumentation
- Lesli website
- Documentation
- Installation guide
- Account management
- Dashboard components
- Translations
- Database
- Release notes
- Issue tracker
- Source code
Community
License
Copyright (c) 2026, Lesli Technologies, S. A.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
The complete license text is available in the license file.
