Skip to content

Strawberry-Foundations/adlsv3

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

76 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Adaptive Design Language by Strawberry V3 (ADLS) 🎨


A modern, clean and responsive design system developed by Strawberry Foundations that combines classic design principles with modern technology

Features

  • 🎨 Modern and clean design language
  • πŸ“± Fully responsive components
  • πŸ”§ Easy to integrate and customize
  • 🎯 Focus on usability and accessibility
  • πŸš€ Lightweight and performant

Components

ADLS includes the following core components:

  • Buttons - Large, medium and small variants
  • Text Fields - With animated labels and focus states
  • Cards - Flexible content containers
  • Chips - Compact interactive elements
  • Dropdowns - Custom styled dropdown menus
  • Navigation - Floating header with responsive navigation

Installation & Usage

Option 1: Using Pre-built Files (CDN)

Include the CSS and JavaScript files directly in your HTML:

<!-- CSS -->
<link rel="stylesheet" href="https://dl.strawberryfoundations.org/w3/static/adlsv3/css/layout/base.css">
<link rel="stylesheet" href="https://dl.strawberryfoundations.org/w3/static/adlsv3/css/layout/nav.css">
<link rel="stylesheet" href="https://dl.strawberryfoundations.org/w3/static/adlsv3/css/components/button.css">
<link rel="stylesheet" href="https://dl.strawberryfoundations.org/w3/static/adlsv3/css/components/textfield.css">
<link rel="stylesheet" href="https://dl.strawberryfoundations.org/w3/static/adlsv3/css/components/base.css">

<!-- JavaScript -->
<script src="https://dl.strawberryfoundations.org/w3/static/adlsv3/js/components.js"></script>

Option 2: Using Built Files (Recommended)

For production use, build the minified version:

# Make the build script executable
chmod +x build.sh

# Build both CSS and JS files
./build.sh

# Or build only specific file types
./build.sh --css    # Build only CSS
./build.sh --js     # Build only JavaScript

Then include the built files:

<!-- Minified CSS (recommended for production) -->
<link rel="stylesheet" href="dist/adlsv3.min.css">

<!-- Non-minified CSS (for development) -->
<link rel="stylesheet" href="dist/adlsv3.css">

<!-- JavaScript -->
<script src="dist/adlsv3.min.js"></script>

We also provide these minified files on our CDN for easy access:

<!-- Minified CSS from CDN -->
<link rel="stylesheet" href="https://dl.strawberryfoundations.org/w3/static/adlsv3/dist/adlsv3.min.css">
<!-- Minified JS from CDN -->
<script src="https://dl.strawberryfoundations.org/w3/static/adlsv3/dist/adlsv3.min.js"></script>

Basic Usage Example

<!DOCTYPE html>
<html>
<head>
    <link rel="stylesheet" href="dist/adlsv3.min.css">
</head>
<body class="smd-layout_body">
    <div class="smd-layout_main">
        <!-- Button example -->
        <a class="smd-component_button-large" href="/">Large Button</a>
        
        <!-- Card example -->
        <div class="smd-component_card">
            <h1>Card Title</h1>
            <p>Card content goes here...</p>
        </div>
    </div>
    
    <script src="dist/adlsv3.min.js"></script>
</body>
</html>

Build System

ADLS includes a powerful build script that combines and minifies all CSS and JavaScript files for optimal performance.

Build Script Usage

# Build both CSS and JavaScript files
./build.sh

# Build only CSS files
./build.sh --css

# Build only JavaScript files
./build.sh --js

# Verbose output (shows detailed file processing)
./build.sh --verbose
./build.sh -v

# Show help
./build.sh --help
./build.sh -h

Build Script Features

  • πŸ”§ Automatic Combination: Combines all CSS/JS files in the correct order
  • πŸ—œοΈ Minification: Removes comments, whitespace, and optimizes file size
  • πŸ“Š Statistics: Shows compression ratios and file sizes
  • πŸ“„ Dual Output: Creates both minified (.min) and readable versions
  • 🎯 Selective Building: Build only CSS or JS files as needed
  • πŸ“ Organized Output: All built files go to the dist/ directory

Build Output

After running the build script, you'll find these files in the dist/ directory:

dist/
β”œβ”€β”€ adlsv3.css          # Combined, readable CSS
β”œβ”€β”€ adlsv3.min.css      # Combined, minified CSS
β”œβ”€β”€ adlsv3.js           # Combined, readable JavaScript
└── adlsv3.min.js       # Combined, minified JavaScript

Build Requirements

The build script requires these standard Unix tools (usually pre-installed on Linux):

  • bash
  • sed
  • bc (for compression calculations)
  • numfmt (for file size formatting)

Customization

ADLS uses CSS variables for easy customization. You can override the default colors and other properties by modifying the root variables:

:root {
    --color-branding-primary: #your-color;
    --color-background-primary: #your-color;
    --color-navbar--primary: rgba(your-rgba-values);
    /* ... */
}

Browser Support

ADLS supports all modern browsers including:

  • Chrome and any Chromium-based browser (latest)
  • Firefox (latest)
  • Safari (latest)

Development

Project Structure

adlsv3/
β”œβ”€β”€ static/
β”‚   β”œβ”€β”€ stylesheet/
β”‚   β”‚   β”œβ”€β”€ layout/
β”‚   β”‚   β”‚   β”œβ”€β”€ base.css
β”‚   β”‚   β”‚   └── nav.css
β”‚   β”‚   └── components/
β”‚   β”‚       β”œβ”€β”€ base.css
β”‚   β”‚       β”œβ”€β”€ button.css
β”‚   β”‚       β”œβ”€β”€ card.css
β”‚   β”‚       β”œβ”€β”€ chip.css
β”‚   β”‚       β”œβ”€β”€ dropdown.css
β”‚   β”‚       └── textfield.css
β”‚   └── js/
β”‚       └── components.js
β”œβ”€β”€ templates/
β”œβ”€β”€ dist/                 # Generated by build script
β”œβ”€β”€ build.sh              # Build script
└── README.md

Contributing to Development

  1. Development Setup: Use individual CSS files for easier debugging
  2. Testing: Test changes across different components and screen sizes
  3. Building: Always run ./build.sh before committing production files
  4. Mobile Testing: Ensure responsive design works on various devices

Version

Current version: m3-1.4.1

License

This project is developed by Strawberry Foundations. All rights reserved.

Contributing

For questions and contributions, please contact Strawberry Foundations:


Built with ❀️ by the Strawberry Foundations team

About

Adaptive Design Language by Strawberry V3 (ADLSv3)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published