Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 37 additions & 12 deletions QUICKSTART.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,24 +31,45 @@ Or via web UI: Settings → Apps → search "nldesign" → Enable
4. Select your organization (Rijkshuisstijl, Utrecht, etc.)
5. Reload the page

🎉 **Done!** Your Nextcloud now uses Dutch government design styling with professional Fira Sans typography.
### 5. Set Background Color (Important!)

The NL Design app does not set a background color automatically. You must configure it in Nextcloud's theming:

1. Stay in: **Settings → Administration → Theming** (Nextcloud's main section)
2. Scroll to: **Background and color** section
3. Click on **Color** and enter the background color for your token set:

| Token Set | Primary Color | Background Color |
|-----------|--------------|------------------|
| **Rijkshuisstijl** | `#154273` (blue) | `#F5F6F7` (light gray) |
| **Utrecht** | `#CC0000` (red) | `#FFFFFF` (white) |
| **Amsterdam** | `#EC0000` (red) | `#FFFFFF` (white) |
| **Den Haag** | `#1A7A3E` (green) | `#FFFFFF` (white) |
| **Rotterdam** | `#00811F` (green) | `#FFFFFF` (white) |

4. **Click on Background image** → Select **Remove background image**
5. Save changes

**Note**: Primary colors are set automatically by NL Design when you select a token set. Only the background color needs manual configuration.

🎉 **Done!** Your Nextcloud now uses Dutch government design styling with professional Fira Sans typography and correct colors.

## 🎨 Token Sets Available

| Set | Color | Best For |
|-----|-------|----------|
| **Rijkshuisstijl** | Blue (#154273) | National government |
| **Utrecht** | Red (#cc0000) | Municipality |
| **Amsterdam** | Red (#ec0000) | Municipality |
| **Den Haag** | Green (#1a7a3e) | Municipality |
| **Rotterdam** | Green (#00811f) | Municipality |
| Token Set | Primary Color | Background | Best For |
|-----------|--------------|------------|----------|
| **Rijkshuisstijl** | `#154273` (blue) | `#F5F6F7` | National government |
| **Utrecht** | `#CC0000` (red) | `#FFFFFF` | Municipality |
| **Amsterdam** | `#EC0000` (red) | `#FFFFFF` | Municipality |
| **Den Haag** | `#1A7A3E` (green) | `#FFFFFF` | Municipality |
| **Rotterdam** | `#00811F` (green) | `#FFFFFF` | Municipality |

## ✅ What You Get

- ✅ Professional Fira Sans typography
- ✅ Official Dutch government colors
- ✅ Sharp corners (Rijkshuisstijl) or rounded (municipalities)
- ✅ Clean white backgrounds
- ✅ Configurable background colors via Nextcloud theming
- ✅ WCAG AA accessible
- ✅ Responsive design
- ✅ No build required
Expand Down Expand Up @@ -98,9 +119,13 @@ docker exec -u 33 nextcloud php occ maintenance:repair

### Colors Wrong?

1. Check which token set is selected
2. Hard reload browser (Ctrl+Shift+R)
3. Clear Nextcloud cache
1. Check which token set is selected in NL Design settings
2. **Check background color** in Nextcloud Theming settings:
- Should be `#F5F6F7` for Rijkshuisstijl
- Should be `#FFFFFF` for other token sets
- Background image should be removed
3. Hard reload browser (Ctrl+Shift+R)
4. Clear Nextcloud cache

## 📖 Full Documentation

Expand Down
31 changes: 31 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,37 @@ Navigate to **Settings → Administration → Theming** and find the "NL Design

Select your preferred design token set and reload the page to see the changes.

### Configuring Background Color

The NL Design app does not set a background color - this allows you to use Nextcloud's built-in theming system to configure the background color to match your organization's needs.

**To set the background color:**

1. Navigate to **Settings → Administration → Theming** (Nextcloud's main theming section, not the NL Design section)
2. Scroll to **Background and color** section
3. Click on **Color** and enter your desired background color
4. **Important**: Also click on **Background image** and select **Remove background image** to ensure a solid color background

**Recommended colors by token set:**

| Token Set | Primary Color | Background Color |
|-----------|--------------|------------------|
| **Rijkshuisstijl** | `#154273` (donkerblauw) | `#F5F6F7` (light gray) |
| **Utrecht** | `#CC0000` (red) | `#FFFFFF` (white) |
| **Amsterdam** | `#EC0000` (red) | `#FFFFFF` (white) |
| **Den Haag** | `#1A7A3E` (green) | `#FFFFFF` (white) |
| **Rotterdam** | `#00811F` (green) | `#FFFFFF` (white) |

**Note**: The primary colors are automatically applied by the NL Design app when you select a token set. You only need to configure the background color manually in Nextcloud's theming settings.

**Why does NL Design not set the background color?**

By delegating background color management to Nextcloud's theming system, organizations can:
- Use their own custom background colors
- Easily change backgrounds without modifying app code
- Maintain compatibility with Nextcloud's theming API
- Allow different backgrounds for different user groups or instances

## Fonts

This app uses **Fira Sans** as an open-source alternative to the proprietary government fonts:
Expand Down
2 changes: 1 addition & 1 deletion appinfo/info.xml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Supported design token sets:

Configure which token set to use in the admin settings.
]]></description>
<version>0.1.1-unstable.2</version>
<version>0.1.1-unstable.4</version>
<licence>agpl</licence>
<author mail="info@conduction.nl" homepage="https://www.conduction.nl/">Conduction</author>
<namespace>NLDesign</namespace>
Expand Down
2 changes: 2 additions & 0 deletions appinfo/routes.php
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,7 @@
'routes' => [
['name' => 'settings#setTokenSet', 'url' => '/settings/tokenset', 'verb' => 'POST'],
['name' => 'settings#getTokenSet', 'url' => '/settings/tokenset', 'verb' => 'GET'],
['name' => 'settings#setSloganSetting', 'url' => '/settings/slogan', 'verb' => 'POST'],
['name' => 'settings#setMenuLabelsSetting', 'url' => '/settings/menulabels', 'verb' => 'POST'],
],
];
Loading