@granite-js/plugin-micro-frontend

Granite ·

English | 한국어

Granite is an enterprise-grade React Native framework for microservice apps with brownfield integration, 200KB bundle sizes, and AWS-ready infrastructure.

• Add React Native to existing apps - Easily integrate React Native screens into your current iOS and Android apps.
• Tiny bundles - Create tiny 200KB microservice bundles with bundle splitting and smart optimization.
• Fast builds - Keep your JavaScript bundle build times down to just seconds using ESBuild.
• Full AWS setup - Complete infrastructure configuration with full deployment control.
• One-click infrastructure - Set up CDN and infrastructure with a single CLI command.
• Simple defaults - Pre-configured settings let you focus on building, not setup.
• Comprehensive end-to-end testing - Every feature comes with end-to-end tests included.
• Fast native builds - Keep your native build times quick with prebuilt frameworks. (WIP)

Getting Started

Getting started with Granite is simple. First, create a new Granite app using our CLI:

npx create-granite-app@latest

Once you've written your React Native components, build your app with a single command:

npm run granite build

Infrastructure Setup

Granite uses Pulumi to make infrastructure setup simple. With just a few lines of code using @granite-js/pulumi-aws, you can deploy your entire React Native infrastructure to AWS:

import * as pulumi from '@pulumi/pulumi';
import * as aws from '@pulumi/aws';
import { ReactNativeBundleCDN } from '@granite-js/pulumi-aws';

const config = new pulumi.Config();

new ReactNativeBundleCDN('myReactNativeBundleCDN', {
  bucketName: config.require('bucketName'),
  region: config.require('region'),
});

Deploying Your App

Deploy your app to production with a single command. Our Forge handles the rest - uploading your bundle and getting it on your CDN.

npm run granite-forge deploy --bucket your-s3-bucket-name

For a simple, step-by-step guide, please visit our getting started guide.

Contributing

We welcome contribution from everyone in the community. Read below for detailed contribution guide.

CONTRIBUTING

License

Apache 2.0 Viva Republica, Inc. See LICENSE for details.