Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/radzionc/radzionkit

RadzionKit: A versatile full-stack development toolkit designed to streamline and enhance your coding projects with a suite of integrated, easy-to-use packages.
https://github.com/radzionc/radzionkit

components dynamodb nodejs react terraform typescript ui

Last synced: 22 days ago
JSON representation

RadzionKit: A versatile full-stack development toolkit designed to streamline and enhance your coding projects with a suite of integrated, easy-to-use packages.

Awesome Lists containing this project

README 

        
# RadzionKit: Speedy Setup for Robust Full-Stack Monorepo Projects



![RadzionKit](https://kit.radzion.com/images/banner-2x.png)



RadzionKit is the ultimate solution for developers looking to jumpstart their projects without the stress of complex setups. Designed as a comprehensive monorepo, it provides an integrated suite of tools for full-stack development, from a robust UI library to streamlined backend services. With RadzionKit, you save valuable time both in kicking off new projects and during the development process, ensuring a smooth, efficient, and hassle-free coding experience. Embrace the power of simplicity and efficiency with RadzionKit — your partner in transforming coding challenges into coding triumphs.



## Monorepo Overview: Inside RadzionKit's Diverse Package Ecosystem



RadzionKit takes advantage of Yarn Workspaces to streamline a monorepo setup, organizing code into two primary directories: `lib` and `product`. The `lib` folder houses generic code packages like `@lib/utils` or `@lib/ui`, designed to be project-agnostic and easily portable to any project without carrying over project-specific logic. On the other hand, the `product` directory houses example implementations, such as `@product/api` or `@product/ui-demo`, that serve as blueprints demonstrating how to integrate and adapt the `@lib` packages to the unique needs of your project. This thoughtful architecture not only streamlines the development process but also enhances the reusability of code, making it effortless to scale and modify your project as it grows.



### Lib Packages



* [**@lib/utils**](lib/utils/README.md) - A collection of utility functions for common tasks.

* [**@lib/ui**](lib/ui/README.md) - A versatile UI library with components, hooks, and utils.

* [**@lib/dynamodb**](lib/dynamodb/README.md) - Utilities for working with AWS DynamoDB.

* [**@lib/dnd**](lib/dnd/README.md) - Components and utilities for drag-and-drop functionality.

* [**@lib/codegen**](lib/codegen/README.md) - Code generation utilities for TypeScript and JSON files.

* [**@lib/countries**](lib/countries/README.md) - Types and utilities for handling country-related data.

* [**@lib/lambda**](lib/lambda/README.md) - Utilities for working with AWS Lambda functions.

* [**@lib/analytics-ui**](lib/analytics-ui/README.md) - Components to integrate Amplitude analytics into your React application.

* [**@lib/auth**](lib/auth/README.md) - Types for authentication sessions and OAuth providers.

* [**@lib/next-ui**](lib/next-ui/README.md) - Components and utilities for Next.js applications.

* [**@lib/subscription-ui**](lib/subscription-ui/README.md) - Components for subscription payments.

* [**@lib/subscriptions**](lib/subscriptions/README.md) - Types for subscription payments.

* [**@lib/chain**](lib/chain/README.md) - Utilities for working with Web3 and blockchain.

* [**@lib/chain-ui**](lib/chain-ui/README.md) - Components for Web3 applications.



### Product Packages



* [**@product/api**](product/api/README.md) - A boilerplate API with user authentication.

* [**@product/api-interface**](product/api-interface/README.md) - Interfaces and types for interacting with the API.

* [**@product/api-ui**](product/api-ui/README.md) - React hooks and components for API interaction.

* [**@product/config**](product/config/README.md) - A shared configuration package for the product.

* [**@product/db**](product/db/README.md) - Database management and utilities.

* [**@product/email**](product/email/README.md) - Email-related services and utilities.

* [**@product/email-forwarder**](product/email-forwarder/README.md) - A Lambda function for forwarding emails.

* [**@product/entities**](product/entities/README.md) - Core entities and models for the product.

* [**@product/entities-utils**](product/entities-utils/README.md) - Utility functions for working with entities.

* [**@product/languages**](product/languages/README.md) - Language support and localization utilities.

* [**@product/languages-next-ui**](product/languages-next-ui/README.md) - Next.js UI components for language handling.

* [**@product/ui-demo**](product/ui-demo/README.md) - Demo UI showcasing product components.

* [**infra**](product/infra/README.md) - Terraform infrastructure for the product.



## Getting Started with RadzionKit: Launching Your New Project



Initiate your project using RadzionKit from our GitHub template. The `demo` folder serves as a practical example, showcasing package integration — rename it to reflect your project's name or remove it if you prefer to start fresh. Update any `@product` references to `@{project_name}`, install dependencies with `yarn`, and your setup is complete.



## Integrating RadzionKit's `lib` Packages into Your Monorepo



Select the `@lib` packages you require from RadzionKit and copy them into your monorepo. Be sure to include all associated dependencies; for example, if you choose `@lib/ui`, check if it necessitates `@lib/utils` and copy it as well. There's no need for renaming—these packages are designed to work out of the box. For practical examples of how these packages can be used within an application, refer to the implementations in the `demo` folder. After incorporating the desired packages, run `yarn` to install the dependencies, and your monorepo will be equipped with the versatile features of RadzionKit.



## Effortlessly Integrate RadzionKit's UI Package: Enhance Your Project's User Interface



1. **For NextJS Projects Only:** Update your `_document.tsx` file by extending the `StyledComponentsDocument` from the `@lib/next-ui` package, in order to integrate support for the `styled-components` library used in the `@lib/ui` package.



```tsx

import { StyledComponentsDocument } from '@lib/next-ui/StyledComponentsDocument'



class MyDocument extends StyledComponentsDocument {

  // ...

}

```



2. **For NextJS Projects Only:** Update your `next.config.js` to set `styledComponents` to `true` in the compiler options for proper styling, and include your UI package in `transpilePackages` to ensure Next.js correctly compiles and includes the UI package from the monorepo.



```javascript

const nextConfig = {

  // ...

  compiler: {

    styledComponents: true,

  },

  transpilePackages: ['@lib/ui'],

}

```



3. Add a `styled.d.ts` to your project and include the following content to integrate RadzionKit's theme with `styled-components`' default theme:



```typescript

import 'styled-components';

import { Theme } from '@lib/ui/theme/Theme';



declare module 'styled-components' {

  export interface DefaultTheme extends Theme {}

}

```



4. **Add `persistentState` File for Local Storage Interaction:** Place a `persistentState` file in the `state` folder of your app package to enhance local storage interaction. For detailed guidance, refer to this YouTube video: [Understanding Persistent State in React](https://youtu.be/_90rzlGy0SM).



```tsx

import { TemporaryStorage } from '@lib/ui/state/TemporaryStorage'

import { LocalStorage } from '@lib/ui/state/LocalStorage'

import { createPersistentStateHook } from '@lib/ui/state/createPersistentStateHook'

import { createPersistentStateManager } from '@lib/ui/state/createPersistentStateManager'



export enum PersistentStateKey {

  ThemePreference = 'themePreference',

}



const persistentStorage =

  typeof window !== 'undefined'

    ? new LocalStorage()

    : new TemporaryStorage()



export const usePersistentState =

  createPersistentStateHook(persistentStorage)



export const managePersistentState =

  createPersistentStateManager(persistentStorage)

```



5. **Implement `ThemeProvider` and `GlobalStyle` in Your App:** In your application, use the `ThemeProvider` from RadzionKit to manage theme changes and store user preferences with the `usePersistentState` hook. Include the `GlobalStyle` component to apply global CSS styles, such as font family and custom scrollbars, ensuring a consistent look and feel across your app.



```tsx

import { GlobalStyle } from '@lib/ui/css/GlobalStyle'

import { Inter } from 'next/font/google'

import { PersistentStateKey, usePersistentState } from '@product/ui-demo/state/persistentState'

import { ThemePreference } from '@lib/ui/theme/ThemePreference'

import { DarkLightThemeProvider } from '@lib/ui/theme/DarkLightThemeProvider'



const inter = Inter({

  subsets: ['latin'],

  weight: ['400', '500', '600', '800'],

})



export const App = () => {

  const [theme, setTheme] = usePersistentState(

    PersistentStateKey.ThemePreference,

    'system',

  )



  return (

    

      

      // ...

    

  )

}

```



## Managing Dependencies & Versions



To upgrade to the latest version of Yarn, run the following command:



```bash

yarn set version stable

```



To upgrade every dependency to the latest version, run the following command:



```bash

yarn workspaces foreach --all exec yarn up "*"

```



## Examples Using RadzionKit



- **[Radzion's Resume](https://resume.radzion.com):** A Web3 Front-end developer resume. [Source code available on GitHub](https://github.com/radzionc/resume).

- **[Pentafret](https://pentafret.com):** A website with guitar music theory tools. [Source code available on GitHub](https://github.com/radzionc/guitar).

- **Crypto:** Receive alerts for cryptocurrency price changes. [Source code available on GitHub](https://github.com/radzionc/crypto)

- **GeorgianCitizen:** An exam prep app. [Source code available on GitHub](https://github.com/radzionc/georgian).

- **[Increaser](https://increaser.org):** A productivity toolkit designed for remote workers.



## RadzionKit Cookbook: Simplifying Development with Practical YouTube Tutorials



To maximize your experience with RadzionKit, we've compiled the RadzionKit Cookbook, a series of YouTube tutorials designed to showcase the toolkit's practical applications in solving everyday development challenges. These tutorials cater to all skill levels, from beginners to experienced developers, and cover a range of topics from initial setup to advanced integrations. The RadzionKit Cookbook videos are an invaluable resource, offering step-by-step instructions, practical tips, and expert insights, all aimed at helping you harness the full power of RadzionKit for efficient, elegant solutions in your development projects.



* [Build a Single-Page Resume with React & TypeScript (Exportable as PDF!)](https://youtu.be/Ujb6Nix1l2g)

* [How to Create an Effective "What's New" Feature for Your Product](https://youtu.be/r2toBBz8t_w)

* [Master Drag-and-Drop with dnd-kit: Kanban Board Tutorial](https://youtu.be/GEaRjSpgycg)

* [Efficiently Delete Inactive User Data Using TypeScript and AWS Lambda](https://youtu.be/hDpjM87x6kE)

* [Creating a DayInput Component with React and TypeScript for Date Selection](https://youtu.be/wXEBxu94t58)

* [Implementing a Custom Dropdown Component in React with TypeScript and Floating-UI](https://youtu.be/qhdqL_2JB7g)

* [Next.js & Amplitude: A Guide to Effective Analytics Integration](https://youtu.be/_XBk-OZR0qg)

* [How to Build a Community-Driven Feature Proposal System with React & NodeJS](https://youtu.be/PXad8WzI0L0)

* [Effortless Email Setup on AWS: Save Time and Money with Lambda and Terraform](https://youtu.be/jgFdZ2kBu0w)

* [Creating an Interactive Time-Tracking Report with React and TypeScript](https://youtu.be/gMZPIyhdQLI)

* [How to Create an Effective Onboarding Flow in React: A Step-by-Step Guide](https://youtu.be/G8U0qAc2MZE)

* [Creating a Drag-and-Drop Todo List in React: A Complete Tutorial](https://youtu.be/GicEFePmO4U)

* [Creating a React Line Chart Component from Scratch](https://youtu.be/8gJ5g0OW6qY)

* [Building a website landing page in TypeScript monorepo: A Developer's guide](https://youtu.be/_v63kPS9-s4)

* [Simplifying TypeScript Backend Development: A Comprehensive Guide](https://youtu.be/BDGR2ji5DWg)

* [Building Internationalization in a Static NextJS Application Without External Libraries](https://youtu.be/V2FgF1AekUQ)

* [NextJS Meta Tags Guide: SEO & PWA Icons](https://youtu.be/uqI6BwnIs8I)

* [Creating a Reusable Combobox with React and TypeScript](https://youtu.be/0Ok3SD4hT-Y)

* [Auto-Generating TypeScript for Dynamic React Components: A Deep Dive](https://youtu.be/_z_kAB5LRgM)

* [Building a Subscription Payments System with Next.js & Node.js](https://youtu.be/ghTNoWkkf-0)

* [Creating a Responsive and Minimalistic Modal Component in React](https://youtu.be/Sp-KmZfUWn8)

* [Magic Link Email Authentication for NextJS + NodeJS Applications](https://youtu.be/b_BZKpeLxO0)

* [Maintaining React State in a URL Query String with NextJS](https://youtu.be/fLx-JvNa450)

* [Full-Stack Implementation of OAuth 2 Authentication (Google & Facebook) with NextJS and NodeJS](https://youtu.be/ysj0XNAolEc)

* [Creating Different Layouts for Different Pages in NextJS](https://youtu.be/hrSBxLlZsCc)

* [Efficient React State Management with usePersistentState and Local Storage](https://youtu.be/_90rzlGy0SM)

* [Useful CSS Utils for React Projects - A Practical Guide](https://youtu.be/wBpoknNn6II)

* [Essential Utilities & Helper Functions for TypeScript Projects](https://youtu.be/bWLeNhFaGRg)

* [How to Set Up a Monorepo with Yarn Workspaces, NextJS, Styled Components, Prettier](https://youtu.be/T6pWiEHVhBE)

* [Deploying a NextJS Static App to AWS S3 and CloudFront](https://youtu.be/ekvQBFsCOnU)

* [Designing a Color Palette for Dark and Light Modes with React, Styled Components and HSLA](https://youtu.be/N5nsvOmSUrU)

* [HSLA Color Format for React: TypeScript, Styled Components, Variants, Colors Generator, Color Picker](https://youtu.be/f3_TYR-8Sd8)

* [Advanced React Button Component Tutorial](https://youtu.be/D2AmZCuk18Q)

* [How To Make Tooltip React Component with Arrow using Floating UI](https://youtu.be/gt-29kdEwtA)

* [Copy Text to Clipboard on Click React Component](https://youtu.be/sUKTden0DSI)

* [How To Make Popover Menu React Component With Floating UI](https://youtu.be/dW9nVeeVc20)

* [How To Make Emoji Input Menu React Component with Emoji Mart](https://youtu.be/sSGxGmUx00g)

* [How To Make Hover Effect Overflow Its Container with React](https://youtu.be/35XAA5Hgag0)

* [How To Make Slider Component with React & Style Range Input](https://youtu.be/HqfFtOh8_50)

* [Building Versatile React Components: Cards and Panels](https://youtu.be/cY-wADVIrRQ)

* [Efficient CSS Layouts with Stack Components](https://youtu.be/iVYo-gqyi90)

* [Dynamic Form with react-hook-form useFieldArray](https://youtu.be/QYVlkk6WMmc)

* [Infinite Scroll Component with React Query](https://youtu.be/mZfDvfs2GtI)

* [A Deep Dive into React: useElementSize Hook and Resize Observing](https://youtu.be/PQ7QKBz_zWE)