Skip to content

Repository files navigation

Simple Tools

Developer tooling for the Simple Platform
Build enterprise applications faster

License


What is Simple Platform?

Simple Platform is an enterprise application development platform built on schema-first principles. Define your data model in human-readable configuration files, and the platform automatically generates:

  • GraphQL APIs — Full CRUD operations, filtering, pagination
  • UI Forms & Lists — Auto-generated from your schema
  • Validation — Same rules run on client AND server (via WebAssembly)
  • Triggers & Webhooks — Schedule actions or respond to events

This repository contains the official developer tools to build, test, and deploy Simple Platform applications.


Available Tools

ToolDescriptionDocumentation
Simple CLICommand-line interface for scaffolding and building applications📖 Full Documentation
ContextualizerCLI to consolidate code for LLM context📖 Full Documentation
SCL Parser CLIStandalone CLI for parsing SCL files to JSON📖 Full Documentation
SCL ParserElixir library for SCL parsing📖 Full Documentation

Quick Start

Prerequisites

This project is configured with Devbox to ensure a consistent development environment.

  1. Install Devbox.
  2. Run devbox shell at the root of the repository to load all necessary tools (Go, Node.js, Elixir, etc.).

Install Simple CLI

# Clone the repository
git clone https://github.com/simple-platform/simple-tools.git
cd simple-tools
# Build all tools (Simple CLI, SCL Parser CLI)
pnpm build
# Verify installation
./tools/simple-cli/simple --help

Create Your First Project

# Initialize a workspace
./tools/simple-cli/simple init my-first-app
cd my-first-app
# Create an application
../tools/simple-cli/simple new app com.mycompany.hello "Hello World"# View generated structure
tree apps/

For detailed usage, see the Simple CLI Documentation.


Development Commands

Run these from the monorepo root:

CommandDescription
pnpm buildBuild all tools (JS/Go/Elixir) via Turbo
pnpm testRun all tests (Go/Elixir) via Turbo
pnpm lintRun all linters (JS/Go/Elixir) via Turbo
pnpm tidyTidy dependencies

Repository Structure

simple-tools/
├── tools/
│ ├── simple-cli/ # Go CLI application
│ ├── contextualizer/ # Go CLI for LLM context
│ └── scl_parser_cli/ # Elixir CLI for SCL Parser
├── packages/
│ └── scl_parser/ # Elixir parser library
├── AGENTS.md # AI coding guidelines
├── package.json # Monorepo scripts
└── pnpm-workspace.yaml # Workspace config

For Contributors

We follow strict engineering standards. Before contributing:

  1. ReadAGENTS.md for coding guidelines
  2. Write tests — 90%+ coverage on business logic
  3. Run checkspnpm lint && pnpm test
  4. Use conventional commitsfeat:, fix:, docs:, etc.

Pull Request Checklist

  • Tests pass locally (go test ./...)
  • Linting passes (golangci-lint run ./...)
  • Coverage maintained/improved
  • Documentation updated if needed

Related Projects

ProjectDescription
Simple SDKsTypeScript SDK for Actions

License

Apache 2.0 — see LICENSE for details.


Built with ❤️ by the Simple Platform team
simple.dev

About

Simple Platform Tools

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages