Download the PHP package ramizasoft/prism without Composer

Prism (Brand Factory Generator)

A high-performance static site generator platform for Amazon sellers to achieve brand verification and own their audience.

Built by RamizaSoft, Prism acts as a "factory" engine that powers 50+ client instances with a shared core, ensuring consistent compliance, performance (100/100 Lighthouse), and professional branding.

Key Features

• Multi-Niche Presets: Instantly switch between "Clinical" (Vitamins), "Playful" (Pet Products), "Luxury", and "Organic" vibes via configuration.
• Compliance Mode: Built-in, automated injection of regulatory requirements (FDA disclaimers for supplements, AAFCO statements for pet food).
• Thin Client Pattern: Manage dozens of client sites from a single versioned core.
• Fleet Management: Batch update and build entire fleets of repositories with a single command.
• Performance Optimized: Architected for 100/100 Lighthouse scores out of the box.

Technology Stack

• Core Engine: Laravel Zero (v12.x)
• SSG: Jigsaw (v1.8.3) with Vite
• Styling: Tailwind CSS (JIT Mode)
• Configuration: Spatie Laravel Data (DTOs)
• Language: PHP 8.2+ (Strict Types)

Getting Started

Prerequisites

• PHP 8.2 or higher
• Composer
• Node.js & NPM

Installation

Option 1: Global Installation (Recommended for creating new projects)

Option 2: Local Installation (For existing projects)

Creating a New Project

The easiest way to start is using the init command.

1. Create a directory:

2. Initialize the project:

   Follow the interactive prompts to set your Project Name, Theme Preset, Compliance Mode, and Brand Color.

   This command automatically:

   • Generates config.php with your settings.
   • Creates bootstrap.php to link the core engine.
   • Sets up composer.json with the correct dependencies.
   • Scaffolds a basic source directory.
3. Install & Build:

Configuration

Client Repository Setup

Prism uses a "Thin Client" pattern. Client repositories depend on the prism core package and should not contain custom PHP logic.

Core Events (bootstrap.php): Add the build listeners to the client's bootstrap.php to enable validation and template loading:

• BuildValidator: Loads config.php, strictly validates it against Spatie Data DTOs, and halts the build on error.
• ThemeInjector: Injects brand colors/preset values into the Jigsaw config for CSS variables and theming.
• TemplateLoader: Registers the correct Blade templates based on the active niche preset.

Usage

1. Building your site

Instead of calling the Jigsaw binary manually, use the Prism wrapper:

2. Fleet Management

Use the Prism CLI to manage updates across multiple client repositories.

Update all clients:

Build all clients:

Fleet File Format (fleet.json):

3. Using Components

Supplement Facts Panel: Renders an FDA-aligned panel. Usage in Blade:

Development

Code Quality

• Strict Typing: All files must start with declare(strict_types=1);.
• Testing: We use Pest PHP. Run tests with ./vendor/bin/pest.
• Formatting: Code must adhere to PSR-12.

Adding Features

1. Core First: Implement logic in prism core, not client repos.
2. Config Driven: Use PrismConfig DTOs to drive behavior.
3. Validate: Add validation rules to DTOs to fail fast.

License

Prism is open-source software licensed under the MIT license.