Last Commit	5d80370 (August 31, 2025 12:00 am)
Repository	https://github.com/magicoli/agnstk
License	MIT

One Core. Any CMS.

What is AGNSTK?

AGNSTK (pronounced "ag-nostic") is the duct tape for your CMS plugins—except it’s reusable, elegant, and won’t leave sticky residue. It’s a single codebase that adapts to WordPress, Drupal, October CMS, Laravel, and more.

Think of it as:

A Swiss Army knife for CMS development.
A universal adapter for your PHP tools.
The glue that binds your logic to any platform.

Why Use AGNSTK?

✅ Write once, deploy anywhere – No more rewriting for each platform.
✅ Multiple deployment targets – CMS plugins, desktop apps, mobile apps, CLI tools, web apps.
✅ Lightweight core – Only ~50KB of glue code (the rest is your logic).
✅ No lock-in – Your business logic stays clean and portable.
✅ Cross-platform – Windows, macOS, Linux support across all deployment targets.
✅ Fun to say – "AGNSTK" sounds like a robot sneezing.

Why "TransKit"? Because "ToolKit" was too boring. AGNSTK transforms your code to fit anywhere—like a chameleon, but for PHP.

How It Works

AGNSTK is built on Laravel, providing a robust core for your logic. Multiple deployment targets then make this core available across different platforms and interfaces.

agnstk/
├── index.php              # Standalone web entry
├── console                # Command-line tool entry
├── exampleapp.php         # WordPress plugin entry
├── exampleapp.module      # Drupal module entry  
├── Plugin.php             # October CMS plugin entry
...                        # Other CMS-specific entry points
├── src/                   # Developer application code (YOUR CODE GOES HERE)
│   ├── Blocks/            # HTML blocks for embedding
│   ├── Pages/             # Page content providers
│   ├── Menus/             # Menu definitions
│   ├── Shortcodes/        # Shortcode handlers
│   ├── Users/             # User management
│   └── Services/          # Cache, sync, external services, etc.
├── core/                   # Laravel core (DO NOT MODIFY except core/config/bundle.php)
│   ├── config/
|   |   ├── bundle.php     #  (YOUR APP INITIAL SETTINGS)
|   |   ├── bundle.example.php     # bundle.php template
│   ...                    # Other core files (DO NOT MODIFY)
├── database/
├── routes/
...

(Want another CMS or deployment target? Open an issue!)

Deployment Targets

Choose how to deploy your AGNSTK application:

🌐 Web Applications

Standalone Laravel app: composer run dev → http://localhost:8000
CMS Plugins: WordPress, Drupal, October CMS, Joomla
REST API: JSON API for data sync across deployment targets

🖥️ Desktop Applications

Cross-platform native: Tauri + embedded PHP runtime
Truly standalone: No PHP installation required, works offline
Data sync: Optional API integration for shared data
All major OS: Windows, macOS, Linux

📱 Mobile Applications

Progressive Web Apps (PWA): Optimized web app experience, works offline
Native mobile apps: iOS and Android via Tauri Mobile
App store ready: Distribute through official app stores
Offline-first: Sync when connected, work when offline

⚡ Command Line Tools

CLI interface: Access core features via terminal
Automation friendly: Perfect for scripts and DevOps workflows
API integration: Bulk operations and data management
Cross-platform: Same commands work everywhere

Developers can enable any combination of these deployment targets for their application.

Data Sync Architecture:

Standalone mode: Each deployment works independently with local data
Connected mode: Optional API sync allows shared data across all deployments
Hybrid approach: Mix standalone and connected deployments as needed
Offline-first: Apps work without internet, sync when available

Installation

For new projects: Clone this repository (which includes the core as a git subtree):

git clone https://github.com/magicoli/agnstk.git my-app
cd my-app
composer install

Enable bundle configuration tracking:


# Remove this line from .gitignore:
core/config/bundle.php

Then track your bundle config:

git add core/config/bundle.php git commit -m "Add bundle configuration"

Then start the development server (Laravel-based standalone app):

composer run dev

The app will be available at http://localhost:8000.

To update the core framework:

git subtree pull --prefix=core https://github.com/magicoli/agnstk-core.git master --squash

Example: Simple Service

Creating a basic AGNSTK service is straightforward – just extend BaseService and implement the essentials:


// src/Services/Example.php
namespace YourAppServices;

use AppServicesBaseService;

class Example extends BaseService { /**

Configure your service */ public static function init(): void { if (static::$initialized) return;

static::$label = (‘Example’); static::$uri = ‘/example’; static::$defaultTitle = (‘Example Page’); static::$defaultContent = _(‘Welcome to AGNSTK!’);

parent::init(); }

/**

Define what your service provides */ public static function provides(): array { if (!empty(static::$provides)) return static::$provides;

static::init(); static::$provides = [ ‘shortcode’ => ‘example’, // Enables {{example}} shortcodes ‘page’ => [ // Creates /example page ‘title’ => static::$defaultTitle, ‘uri’ => static::$uri, ], ‘menu’ => [ // Adds menu item ‘label’ => static::$label, ‘uri’ => static::$uri, ‘enabled’ => true, ], ];

return static::$provides; }

/**

Your core functionality */ public function render(array $options = []): array { $content = $options[‘content’] ?? $this->content ?? static::$defaultContent;

return [ ‘title’ => $this->title, ‘content’ => $content, ]; } }

That’s it! Your service now automatically provides:

{{example}} shortcodes in content
/example page route
Example menu item
Block embedding capability

Now use {{example}} in any CMS content!

ExampleApp – AGNSTK Proof of Concept

This is a CMS-agnostic application framework that allows you to write your core business logic once and deploy it across multiple platforms.

Current Status

AGNSTK is currently implemented as a Laravel 12 application with multiple deployment targets:

Laravel standalone app: Available at http://localhost:8000 when running composer run dev
WordPress plugin: Install as plugin with exampleapp.php as main file
Drupal module: Available in deploy/adapters/drupal/
October CMS plugin: Available in deploy/adapters/octobercms/
Desktop app: Tauri-based native application (in development)
Mobile PWA: Progressive Web App with offline capabilities (in development)
Mobile native: iOS/Android apps via Tauri Mobile (in development)
REST API: JSON API for cross-deployment data sync (in development)
CLI tool: Command-line interface (in development)

Quick Test

Standalone Laravel: Run composer run dev and visit http://localhost:8000
WordPress: Copy the full project folder to your plugins directory and activate (for production, delete irrelevant deployment targets)

Core Features

Laravel 12 framework providing robust AGNSTK core (hands-off for developers)
Configurable objects: Pages, Menus, Blocks, Shortcodes, Users, Services
Developer-friendly: Put your code in src/, configure via core/config/bundle.php
Bootstrap UI: Clean, responsive interface for web deployments
Markdown support: Content rendering with syntax highlighting
Cross-platform deployment: Same codebase runs on web, desktop, and CLI
Platform-specific adapters handle CMS integration and user authentication

Contributing

Found a bug? github.com/magicoli/agnstk/issues
Want help or discuss a related matter? github.com/magicoli/agnstk/discussions
Want to add a CMS? Open a an issue on GitHub.

Code of Conduct: Be nice. We’re all just trying to glue things together. License: MIT (use it, break it, fix it).

Made with ❤️ and duct tape by magicoli.

AGNSTK – Agnostic Glue for Non-Specific ToolKits