@gg-software/cms
v1.0.1
Published
GG Software CMS building blocks: ready-made React admin layouts, auth flows, CRUD forms and tables, content editors, dashboards, and settings.
Readme
@gg-software/cms
Building blocks for admin panels and CMS dashboards — ready-made React admin
layouts, auth flows, CRUD forms and tables, content editors, dashboards, and
settings pages. Built on top of @gg-software/ui,
@gg-software/auth, and
@gg-software/utils.
Installation
pnpm add @gg-software/cms react react-dom
# or: npm install @gg-software/cms react react-domreact and react-dom are peer dependencies (React 19+). The @gg-software/ui,
@gg-software/auth, and @gg-software/utils packages are installed
automatically as dependencies.
Setup
Import both stylesheets at the root of your app — the UI tokens/components first, then the CMS styles:
import "@gg-software/ui/styles.css";
import "@gg-software/cms/styles.css";Usage
Compose a full admin screen from the layout, CRUD, and dashboard pieces:
import { AdminLayout, PageHeader, ResourceTable } from "@gg-software/cms";
export function UsersPage() {
return (
<AdminLayout>
<PageHeader title="Users" />
<ResourceTable
columns={[
{ key: "name", header: "Name" },
{ key: "email", header: "Email" },
]}
rows={users}
/>
</AdminLayout>
);
}A schema-driven create/edit form:
import { ResourceForm } from "@gg-software/cms";
<ResourceForm
fields={[
{ name: "title", type: "text", label: "Title" },
{ name: "status", type: "select", label: "Status", options: [
{ value: "draft", label: "Draft" },
{ value: "published", label: "Published" },
] },
]}
onSubmit={(values) => save(values)}
/>;What's included
- Layout —
AdminLayout,DashboardLayout,PageHeader,NavSidebar,UserMenu,NotificationCenter - Auth flows —
LoginForm,LoginPage,ForgotPasswordForm,ResetPasswordForm,PermissionGate - CRUD —
FormBuilder,ResourceForm,ResourceTable,DetailView,FilterBar,BulkActions,DataTableToolbar,ConfirmDeleteDialog,DataExport/toCsv, plusFieldDefschema helpers (initialValuesFor) - Content —
RichTextEditor,MarkdownEditor/renderMarkdown,MediaLibrary,ImageUploader,SEOFields,ContentScheduler - Dashboard —
StatCard,KpiGrid,ActivityFeed,AuditLog - Settings —
SettingsLayout,SettingsForm,ProfileForm
Every component ships full TypeScript types.
License
MIT © GG Software
