Welcome to Puppertino Siberian by Codedgar

Welcome to Puppertino! This framework brings the macOS look and feel to your web applications, adhering closely to Apple’s Human Interface Guidelines. Designed to be lightweight and modular, Puppertino provides a seamless user experience with a focus on performance and style.

Key Framework Features

• Lightweight: Puppertino is built with performance in mind. By avoiding unnecessary additions or dependencies, Puppertino ensures your website or app remains fast and responsive. You get the macOS-inspired design without compromising on speed and efficiency.
• Modular: Flexibility is at the heart of Puppertino. Whether you need the entire framework or just specific components, you can pick and choose what fits your project. This modular approach allows you to minimize the size of your website, ensuring that you only include what’s necessary.
• Design-Focused: Puppertino is not just about functionality—it’s about looking cool too! Inspired by macOS, the framework prioritizes a sleek and modern design, with room for creative enhancements beyond macOS guidelines when needed.

Table of contents

• Get Started
• Current Components
• Examples and templates
• About the creator

Get Started

To integrate Puppertino into your project, simply include the full.css file in your HTML head tag:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/codedgar/Puppertino@latest/dist/css/newfull.css">

Customize your setup

If you only need specific components, you can import them individually to reduce file size. Here’s how you can include only the buttons:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/codedgar/Puppertino@latest/dist/css/buttons.css">

You can also find the full list of individual components and their CDN links on the Components page.

NPM

You can install Puppertino through NPM directly from the GitHub repository:

# Via NPM (recommended)
npm install @codedgar/puppertino@github:codedgar/Puppertino

# Or install from a specific branch
npm install @codedgar/puppertino@github:codedgar/Puppertino#master

# Via SSH
npm install git+ssh://[email protected]/codedgar/Puppertino.git

# Via HTTPS
npm install https://github.com/codedgar/Puppertino.git

Usage after installation

Once installed, you can import Puppertino in several ways depending on your build setup:

Import the full framework:

// In JavaScript/TypeScript
import '@codedgar/puppertino'

// In CSS
@import '@codedgar/puppertino';

Import individual components (modular approach):

// Import only what you need
import '@codedgar/puppertino/buttons'
import '@codedgar/puppertino/modals'
import '@codedgar/puppertino/forms'
import '@codedgar/puppertino/tabs'

Import JavaScript modules:

// ES6 imports
import '@codedgar/puppertino/js/modals.js'
import '@codedgar/puppertino/js/dakmode_manager.js'
import '@codedgar/puppertino/js/tabs.js'

// CommonJS require
const modals = require('@codedgar/puppertino/src/js/modals.js')

Direct CSS imports:

/* Import full framework */
@import '@codedgar/puppertino';

/* Or import individual components */
@import '@codedgar/puppertino/buttons';
@import '@codedgar/puppertino/modals';
@import '@codedgar/puppertino/dark-mode';

Current Components

Puppertino currently includes the following components:

• Buttons (Push, Icon, Action)
• Modals
• Forms and Inputs
• Layout
• Official Apple Colors
• Segmented Controls
• Shadows & Blur
• Tabs
• Navigation Bars
• Dark Mode Manager

For a full list and detailed usage instructions, check out the Components page.

If you can't find a component that you want, you can always create an issue to vote for the new components.

Examples and templates

Find detailed examples and templates to help you get started quickly with Puppertino.

Explore the examples at Puppertino Examples.

License

Puppertino is open-source and available under the open-source MIT license, allowing you to freely use and modify the framework for your projects.

Contributing

We welcome contributions! If you’d like to contribute to Puppertino, check out the Contribution Guidelines to learn how to get involved.

About the creator

Puppertino was developed by Codedgar, a web developer passionate about creating clean, elegant web experiences. As the framework continues to evolve, more features and components will be added—so stay tuned for regular updates!