bench get-app https://github.com/francis450/erpkenya_base

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=francis450%2Ferpkenya_base)](https://frappegems.com/gems/apps/francis450/erpkenya_base)

# ERPKenya Base Branding App A Frappe custom app that replaces both the public home page and the login page with ERPKenya-branded versions across all demo sites. It exposes named Jinja blocks so domain-specific child apps (e.g. `erpkenya_hospitality`) can override sections without rewriting the full templates. ## How It Works Frappe resolves `www/` pages by iterating installed apps in **reverse order** — the last installed app wins. So `erpkenya_base` shadows Frappe's default `www/login.html` and provides a new `www/index.html` home page. The `home_page` hook points `/` to `index`. Domain-specific child apps, installed after `erpkenya_base`, can shadow the same `www/` files and use `{% extends %}` on the base ERPKenya templates to override only the blocks they need. ## Architecture ### Template Inheritance Chain ``` Frappe base.html └── Frappe web.html ├── erpkenya_base/templates/erpkenya/home_base.html (branded home page) │ └── erpkenya_base/www/index.html (thin wrapper) │ └── erpkenya_hospitality/www/index.html (domain child override) │ └── erpkenya_base/templates/erpkenya/login_base.html (branded login page) └── erpkenya_base/www/login.html (thin wrapper) └── erpkenya_hospitality/www/login.html (domain child override) ``` ### Overridable Blocks (prefixed `erpkenya_` to avoid collisions) **Home page (`home_base.html`):** | Block | Purpose | |-------|---------| | `erpkenya_hero` | Hero section: logo, tagline, CTA button | | `erpkenya_features` | Feature cards grid (default: generic ERP features) | | `erpkenya_about` | About / description section | | `erpkenya_cta` | Call-to-action section ("Start your demo") | | `erpkenya_footer` | Branded footer: company info, links, social | | `erpkenya_styles` | Extra CSS slot | | `erpkenya_scripts` | Extra JS slot | **Login page (`login_base.html`):** | Block | Purpose | |-------|---------| | `erpkenya_login_logo` | Logo above the login card | | `erpkenya_login_title` | "Welcome to ERPKenya" heading | | `erpkenya_login_form` | Email/password form (retains Frappe login JS) | | `erpkenya_login_footer` | Footer text beneath the card | | `erpkenya_login_background` | Background styling / images | | `erpkenya_login_branding` | "Powered by ERPKenya" bottom bar | | `erpkenya_login_styles` | Extra CSS slot | ## Installation ```bash cd /home/frappeuser/frappe-bench # Install to all sites bench --site all install-app erpkenya_base # Build assets bench build --app erpkenya_base ``` ## Creating a Domain-Specific Child App For domain-specific customization (e.g., hospitality), create a separate app installed **after** `erpkenya_base`: ### Home page override Create `erpkenya_hospitality/www/index.html`: ```jinja {% extends "templates/erpkenya/home_base.html" %} {% block erpkenya_hero %}

Hospitality Management, Simplified

Complete hotel & restaurant ERP solution by ERPKenya

Start Your Demo

{% endblock %} ``` ### Login page override (optional) Create `erpkenya_hospitality/www/login.html`: ```jinja {% extends "templates/erpkenya/login_base.html" %} {% block erpkenya_login_title %} {% endblock %} ``` ### Install order matters The child app **must** be installed after `erpkenya_base` so its `www/` files win the resolution order. ## ERPKenya Color Palette | Token | Value | Usage | |-------|-------|-------| | Primary | `#1B5E20` | Buttons, links, accents (Kenya green) | | Primary Dark | `#0D3B12` | Hover states, dark accents | | Secondary | `#B71C1C` | Highlights, badges (Kenya red) | | Accent | `#E8A817` | CTAs, featured elements | | Background | `#FAFAFA` | Page background | | Surface | `#FFFFFF` | Cards, login form | | Text | `#212121` | Body text | | Text Light | `#666666` | Secondary text | ## License MIT ### License mit