https://github.com/storm-software/cyclone-ui
🌀 Tamagui Web/Mobile universal components + Shadcn UI's style of distributing code - Cyclone UI components are copied into your repositories via the CLI tool.
https://github.com/storm-software/cyclone-ui
expo nextjs onestack react react-native shadcn-ui tamagui
Last synced: 3 months ago
JSON representation
🌀 Tamagui Web/Mobile universal components + Shadcn UI's style of distributing code - Cyclone UI components are copied into your repositories via the CLI tool.
- Host: GitHub
- URL: https://github.com/storm-software/cyclone-ui
- Owner: storm-software
- License: apache-2.0
- Created: 2024-04-09T12:34:36.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-05T12:16:32.000Z (3 months ago)
- Last Synced: 2025-07-05T13:22:41.723Z (3 months ago)
- Topics: expo, nextjs, onestack, react, react-native, shadcn-ui, tamagui
- Language: TypeScript
- Homepage: https://cyclone-ui.com
- Size: 10.3 MB
- Stars: 10
- Watchers: 0
- Forks: 1
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
🌀 The Cyclone UI repository contains core front-end components used by Storm Software in various applications across many platforms.
⚡ Storm Workspaces are built using
Nx, a set of extensible dev tools
for monorepos, which helps you develop like Google, Facebook, and Microsoft.
Building on top of Nx, the Open System provides a set of tools and patterns that
help you scale your monorepo to many teams while keeping the codebase
maintainable.
💻 Visit stormsoftware.com to stay up to date with this developer
[](https://github.com/storm-software/cyclone-ui) [](http://nx.dev/) [](https://nextjs.org/) [](http://commitizen.github.io/cz-cli/)   
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fstorm-software%2Fcyclone-ui?ref=badge_large&issueType=license)
> [!IMPORTANT]
> This repository, and the apps, libraries, and tools contained within, is still in it's initial development phase. As a result, bugs and issues are expected with it's usage. When the main development phase completes, a proper release will be performed, the packages will be availible through NPM (and other distributions), and this message will be removed. However, in the meantime, please feel free to report any issues you may come across.
[](https://github.com/storm-software/cyclone-ui/actions)
## Table of Contents
- [Quick Features](#quick-features)
- [Tech Stack](#tech-stack)
- [Getting Started](#getting-started)
- [Build](#build)
- [Development Server](#development-server)
- [Acidic - Model-Driven Development](#acidic---model-driven-development)
- [Visual Studio Code Extension](#visual-studio-code-extension)
- [Environment Configuration Help](#environment-configuration-help)
- [Plug-Ins](#plug-ins)
- [Generate an Application](#generate-an-application)
- [Generate a Library](#generate-a-library)
- [Code Scaffolding](#code-scaffolding)
- [Testing](#testing)
- [Running Unit Tests](#running-unit-tests)
- [Running End-to-End Tests](#running-end-to-end-tests)
- [Understand your workspace](#understand-your-workspace)
- [☁ Nx Cloud](#-nx-cloud)
- [Distributed Computation Caching \& Distributed Task Execution](#distributed-computation-caching--distributed-task-execution)
- [Roadmap](#roadmap)
- [Contributing](#contributing)
- [Support](#support)
- [License](#license)
- [Contributors ✨](#contributors-)
# Quick Features
The following are some of the features/publishable code that are included in
this repository:
- Transport/protocol/backend agnostic data fetching (REST, GraphQL, promises,
whatever!)
- Auto Caching + Refetching (stale-while-revalidate, Window Refocus,
Polling/Realtime)
- Parallel + Dependent Queries
- Mutations + Reactive Query Refetching
- Multi-layer Cache + Automatic Garbage Collection
- Paginated + Cursor-based Queries
- Load-More + Infinite Scroll Queries w/ Scroll Recovery
- Request Cancellation
- React Suspense + Fetch-As-You-Render Query Prefetching
- Dedicated Devtools
## Tech Stack
**Note:** The above list of technologies is far from exhaustive. It is just
meant to serve as a short list of _some_ of the technologies that are used in
this repository.
# Getting Started
Once the code is pulled locally, open a command prompt and run `pnpm install` in
the root repo directory (/storm-stack).
More information can be found in the
[Open System documentation](https://storm-software.github.io/storm-stack/docs/getting-started/installation).
## Build
Run `pnpm build` to build the project. The build artifacts will be stored in the
`dist/` directory. Use the `--prod` flag for a production build.
## Development Server
Run `pnpm serve` for a dev server. Navigate to . The app
will automatically reload if you change any of the source files.
# Acidic - Model-Driven Development
In StormStack, ⚡ _acidic_ refers to a collection of applications and libraries
that are used to build server-side code from a user-defined model. This
functionality all lives in the Storm monorepo's `tools` directory
(/tools/acidic).
More information can be found in the
[📓 Documentation](https://acidicjs.com/docs).
## Visual Studio Code Extension
Acidic has it's own Visual Studio Code extension to support the language model
in the IDE. The extension can be found in the
[Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=storm-software.acidic).
# Environment Configuration Help
If you run into any issues while trying to run any of the above steps, please
reach out to Patrick Sullivan. See the [Support](#support) section for more
information.
## Plug-Ins
Some of the plug-ins used by this repository are:
- [@nx/next](https://nx.dev/packages/next)
- [@nx/react](https://nx.dev/packages/react)
- [@nx/lint](https://nx.dev/linter/overview)
- [@nx/js](https://nx.dev/js/overview)
- [@nx/node](https://nodejs.org)
- [@nx/web](https://nx.dev/web/overview)
- [@nx/storybook](https://nx.dev/storybook/overview-react)
- [@nx/cypress](https://nx.dev/packages/cypress)
- [@nx/jest](https://nx.dev/packages/jest)
- And more...
## Generate an Application
Run `nx g @storm-software/workspace:app my-app` to generate an application.
> You can use any of the plugins above to generate applications as well.
When using Nx, you can create multiple applications and libraries in the same
workspace.
## Generate a Library
Run `nx g @storm-software/workspace:lib my-lib` to generate a library.
> You can also use any of the plugins above to generate libraries as well.
Libraries are shareable across libraries and applications. They can be imported
from `@storm-stack/my-lib`.
## Code Scaffolding
Run `nx g @nx/react:component my-component --project=storm-stack` to generate a
new component.
# Testing
Open System uses [Jest](https://jestjs.io/) for unit testing and
[Cypress](https://www.cypress.io/) for end-to-end testing.
## Running Unit Tests
Run `pnpm test` to execute the unit tests via [Jest](https://jestjs.io).
Run `pnpm affected:test` to execute the unit tests affected by a change.
## Running End-to-End Tests
Run `pnpm e2e` to execute the end-to-end tests via
[Cypress](https://www.cypress.io).
Run `pnpm affected:e2e` to execute the end-to-end tests affected by a change.
## Understand your workspace
Run `pnpm graph` to see a diagram of the dependencies of the Open System
projects.
# ☁ Nx Cloud
Nx caches the output of any previously run command such as testing and building,
so it can replay the cached results instead of rerunning it. Nx Cloud allows you
to share the computation cache across everyone in your team and CI.
## Distributed Computation Caching & Distributed Task Execution
Nx Cloud pairs with Nx in order to enable you to build and test code more
rapidly, by up to 10 times. Even teams that are new to Nx can connect to Nx
Cloud and start saving time instantly.
Teams using Nx gain the advantage of building full-stack applications with their
preferred framework alongside Nx’s advanced code generation and project
dependency graph, plus a unified experience for both frontend and backend
developers.
Visit [Nx Cloud](https://nx.app/) to learn more.
# Roadmap
See the [open issues](https://github.com/storm-software/cyclone-ui/issues) for a
list of proposed features (and known issues).
- [Top Feature Requests](https://github.com/storm-software/cyclone-ui/issues?q=label%3Aenhancement+is%3Aopen+sort%3Areactions-%2B1-desc)
(Add your votes using the 👍 reaction)
- [Top Bugs](https://github.com/storm-software/cyclone-ui/issues?q=is%3Aissue+is%3Aopen+label%3Abug+sort%3Areactions-%2B1-desc)
(Add your votes using the 👍 reaction)
- [Newest Bugs](https://github.com/storm-software/cyclone-ui/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
# Contributing
First off, thanks for taking the time to contribute! Contributions are what
makes the open-source community such an amazing place to learn, inspire, and
create. Any contributions you make will benefit everybody else and are **greatly
appreciated**.
Please try to create bug reports that are:
- _Reproducible._ Include steps to reproduce the problem.
- _Specific._ Include as much detail as possible: which version, what
environment, etc.
- _Unique._ Do not duplicate existing opened issues.
- _Scoped to a Single Bug._ One bug per report.
Please adhere to this project's [code of conduct](.github/CODE_OF_CONDUCT.md).
You can use
[markdownlint-cli](https://github.com/storm-software/cyclone-ui/markdownlint-cli)
to check for common markdown style inconsistency.
# Support
Reach out to the maintainer at one of the following places:
- [Contact](https://stormsoftware.com/contact)
- [GitHub discussions](https://github.com/storm-software/cyclone-ui/discussions)
-
# License
This project is licensed under the **Apache License 2.0**. Feel free to edit and
distribute this template as you like. If you have any specific questions, please
reach out to the Storm Software development team.
See [LICENSE](LICENSE) for more information.
# Contributors ✨
Thanks goes to these wonderful people
([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Patrick Sullivan
🎨 💻 🔧 📖 ⚠️
Tyler Benning
🎨
Stormie
🚧
Add your contributions
This project follows the
[all-contributors](https://github.com/all-contributors/all-contributors)
specification. Contributions of any kind welcome!
Fingerprint: 1BD2 7192 7770 2549 F4C9 F238 E6AD C420 DA5C 4C2D
💻 Visit stormsoftware.com to stay up to date with this developer