8000 GitHub - jorik041/orbit: 💫 Orbit is the first CSS framework designed specifically for building radial user interfaces!
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content
/ orbit Public
forked from zumerlab/orbit

💫 Orbit is the first CSS framework designed specifically for building radial user interfaces!

License

Notifications You must be signed in to change notification settings

jorik041/orbit

 
 

Repository files navigation

⚙️ Install🤖 Features🎮 Examples📚 Docs💬 Github Discussions🧑‍💻 Telegram Group

Use Orbit to create amazing radial UIs using CSS only!

Get involved, leave a star

🖖 Orbit in a nutshell

Orbit is the first CSS framework designed specifically for radial user interfaces. We've used the latest CSS features to make building radial layouts a breeze. It provides intuitive CSS classes and Custom Elements for building radial menus, dashboards, creative portfolios, or a cutting-edge applications.

Status

We’re in the early stages of development, things are still evolving. You’re welcome to explore and experiment, but keep in mind that names, features, and functionalities may change as we refine our project. We appreciate your understanding and flexibility during this exciting phase!

Features

With Orbit, you can:

  • Simplify your development process using our predefined CSS classes that do the heavy lifting.

  • Get started quickly with our detailed documentation, examples, and guides that walk you through using Orbit's features effectively.

The best part? Orbit plays nicely with your favorite CSS framework! Our goal is for Orbit to complement, not compete with, other frameworks.

🚀 Try Orbit now!

To quickly get a taste of Orbit, you can try it directly in a Orbit Codepen template.

Installation

Orbit comes with just two files: orbit.css (or orbit.min.css), and orbit.js (or orbit.min.js).

Getting the Orbit files:

You have three ways to get Orbit files:

1. Download the Orbit files

2. Use Orbit via CDN (content delivery network)

3. Install Orbit via a Package Manager

You can also install Orbit using npm or yarn:

npm install @zumer/orbit

Or

yarn add @zumer/orbit

Setting up Orbit in your project:

After install Orbit, follow this simple steps to get Orbit working.

Link Orbit files or CDN in your HTML file:

If you have downloaded them just use <link> tag for the CSS file, and <script> tag for the JS file within the <head> section:

In case you have downloaded the files:

<head>
  <link rel="stylesheet" href="path/to/orbit.css">
  <script src="path/to/orbit.js"></script>
</head>

In case you are using CDN:

<head>
  <link rel="stylesheet" href="https://unpkg.com/@zumer/orbit@latest/dist/orbit.css">
  <script src="https://unpkg.com/@zumer/orbit@latest/dist/orbit.js"></script>
</head>

Tip for CSS file: You can use @import CSS rule in your <style> tag to import the CSS file:

Downloaded file:

@import url('path/to/orbit.css');

Or via CDN:

@import url('https://unpkg.com/@zumer/orbit@latest/dist/orbit.css');

🏁 Quick start

Basic Orbit layout

Just add .bigbang CSS class in a HTML element like <div>. Then use .gravity-spot class, and within it, add another element with .orbit class. Finally, inside .orbit element, add radial elements, such us: .satellite, .vector, .side, or <o-text>, <o-slice>, <o-progress> web components . Here’s a minimal working example:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <link rel="stylesheet" href="https://unpkg.com/@zumer/orbit@latest/dist/orbit.css" />
    <script src="https://unpkg.com/@zumer/orbit@latest/dist/orbit.js" defer></script>
    <title>Orbit Quick Start</title>
  </head>
  <body>
    <div class="bigbang">
      <div class="gravity-spot">
        <div class="orbit">
          <div class="satellite">1</div>
          <div class="satellite">2</div>
          <div class="satellite">3</div>
        </div>
        <div class="orbit">
          <o-text>Curved text</o-text>
        </div>
      </div>
    </div>
  </body>
</html>

Radial elements

Bigbang

The foundation of every Orbit project, serving as a container for your application.

Gravity-spot

The parent container for organizing Orbit elements within a radial layout.

Orbit

Defines a circular path around a .gravity-spot, with variations from .orbit-0 to .orbit-24. Within .orbit element, various Orbit elements such as satellites, o-slices, o-progress, vectors, sides, and o-texts can be positioned.

Satellite

Places elements along an .orbit or .orbit-* path, serving as content containers or nesting points for other orbits.

Vector

Renders perpendicular lines across orbits, perfect for creating connector lines or minute marks.

Side

Generates a regular polygon figure when used with other sides.

O-Text

A web-component for rendering curved text.

O-Slice

A web-component for rendering radial slices, arcs, or pies.

O-Progress

A web-component for rendering a radial progress bar.

Examples

A dashboard

An orbital map

A watch

The solar system

Show & Tell:

Join to Discussion section and show off what have you done with Orbit.

🥋 Mastering Orbit

Read the Orbit docs here.

Stay in orbit

There are many ways to contribute to Orbit development:

  • Contribution guidelines: This guide outlines how you can contribute to Orbit, help us test and improve it, and share your experiences with the community.
  • GitHub discussions: Engage with other contributors, ask questions, and share your experiences.
  • Telegram group: Join our Telegram group for real-time discussions and updates.

License

MIT

About

💫 Orbit is the first CSS framework designed specifically for building radial user interfaces!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • SCSS 53.6%
  • JavaScript 46.4%
0