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.
- 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.
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">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.
You can install this repository through NPM + GIT:
# Via SSH
npm i --save [email protected]:codedgar/Puppertino.git#{{BRANCH_NAME}}
# Eg.
npm i --save [email protected]:codedgar/Puppertino.git#master
# Or Via HTTPS
npm i --save https://github.com/codedgar/Puppertino.git#BRANCH_NAME
# Eg.
npm i --save https://github.com/codedgar/Puppertino.git#masterYou can change master with the branch of your choosing to install a specific branch. After NPM installation,
you can simply import the library from node_modules
@import("path/to/node_modules/puppertino/dist/full.css")require("path/to/node_modules/puppertino/src/js/{{file you need, eg tabs.js}}")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.
Find detailed examples and templates to help you get started quickly with Puppertino.
Explore the examples at Puppertino Examples.
Puppertino is open-source and available under the open-source MIT license, allowing you to freely use and modify the framework for your projects.
We welcome contributions! If you’d like to contribute to Puppertino, check out the Contribution Guidelines to learn how to get involved.
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!
