https://github.com/kikplate/kikplate
Open source marketplace for project templates and boilerplates. Browse, contribute, and scaffold new projects in seconds.
https://github.com/kikplate/kikplate
golang java javascript nodejs programming react typescript
Last synced: 25 days ago
JSON representation
Open source marketplace for project templates and boilerplates. Browse, contribute, and scaffold new projects in seconds.
- Host: GitHub
- URL: https://github.com/kikplate/kikplate
- Owner: kikplate
- License: apache-2.0
- Created: 2026-03-15T14:54:54.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-11T15:17:12.000Z (about 1 month ago)
- Last Synced: 2026-05-11T16:34:24.106Z (about 1 month ago)
- Topics: golang, java, javascript, nodejs, programming, react, typescript
- Language: TypeScript
- Homepage: http://kikplate.dev
- Size: 12.6 MB
- Stars: 5
- Watchers: 0
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://artifacthub.io/packages/search?repo=kikplate)
[](https://github.com/kikplate/kikplate)
# Kikplate
Kikplate is an open source marketplace for project templates and boilerplates. Teams publish templates backed by real GitHub repositories, developers browse and filter by category, language, or badge tier, and the CLI scaffolds new projects in seconds.
## Overview
| Topic | Description |
|-------|-------------|
| **Templates as code** | Every template ("plate") is a public GitHub repository containing a `kikplate.yaml` manifest. There is nothing to upload — the source of truth is always the repository. |
| **Verification workflow** | Submitting a plate issues a one-time token. Placing that token in `kikplate.yaml` and calling `verify` proves ownership and moves the plate to the approved state. |
| **Continuous sync** | The background sync worker periodically re-reads each approved plate's `kikplate.yaml`, updating metadata and catching drift or revocation automatically. |
| **Organizations** | Plates can be scoped to an organization, enabling teams and companies to maintain shared template catalogs under a single namespace. |
| **Badges** | Admins award badges (community, verified, official, sponsored) to signal quality and curation level. |
| **CLI** | The `kikplate` CLI handles authentication, searching, describing, and scaffolding templates without touching a browser. |
---
## Quick Start
The fastest way to run Kikplate locally is with Docker Compose.
```sh
git clone https://github.com/your-org/kikplate.git
cd kikplate
cp config/examples/config.yaml.example config/config.yaml
# Edit config/config.yaml — set database.dsn and jwt_secret at minimum.
docker compose up -d
docker compose exec api ./api db:seed
```
The API is available at `http://localhost:3001` and the web UI at `http://localhost:3000`.
Install the CLI to interact from a terminal.
## Install CLI
### macOS/Linux via Homebrew tap
```sh
brew tap kikplate/homebrew-kikplate
brew install kikplate
```
### Windows via Scoop
```powershell
scoop bucket add kikplate https://github.com/kikplate/scoop-bucket.git
scoop install kikplate
```
### Manual install from release archives (all platforms)
```sh
# Linux/macOS
tar -xzf kikplate--linux-amd64.tar.gz
sudo install kikplate--linux-amd64 /usr/local/bin/kikplate
# macOS example
tar -xzf kikplate--darwin-arm64.tar.gz
sudo install kikplate--darwin-arm64 /usr/local/bin/kikplate
```
```powershell
# Windows (PowerShell)
Expand-Archive .\kikplate--windows-amd64.zip -DestinationPath .
Move-Item .\kikplate--windows-amd64.exe kikplate.exe
# Add the folder containing kikplate.exe to PATH
```
### Build from source
```sh
go install github.com/kikplate/kikplate/cli@latest
```
Quick sanity check:
```sh
kikplate --help
kikplate config init
kikplate login
kikplate search --category backend
```
---
## Documentation
| Document | Description |
|----------|-------------|
| [Getting Started](docs/getting-started.md) | Prerequisites, local setup, dev workflow, running tests |
| [How It Works](docs/how-it-works.md) | Core concepts: plates, kikplate.yaml, verification lifecycle, sync, badges |
| [Architecture](docs/architecture.md) | Component map, layers, HTTP surface, DI modules, data flow diagrams |
| [Database](docs/database.md) | Schema reference, table definitions, entity relationships |
| [Configuration](docs/configuration.md) | All config file keys and environment variable overrides |
| [CLI Reference](docs/cli.md) | Full reference for every `kikplate` command with flags and examples |
| [Kubernetes](docs/kubernetes.md) | Deploying to Kubernetes with `kubectl apply -k`, secrets, ingress, scaling |
| [Helm](docs/helm.md) | Helm chart install, upgrade, full values reference, production example |
| [Contributing](docs/contributing.md) | Repo structure, branching, commit conventions, adding endpoints, PR process, release flow |
| [OpenAPI](docs/openapi.yaml) | Machine-readable API specification (OpenAPI 3.0.3) |
---
## Repository Layout
```
api/ Go API server (Chi, Uber Fx, GORM)
cli/ Go CLI client (Cobra)
web/ Next.js frontend
config/ Default configuration file and examples
docs/ All documentation including OpenAPI spec
helm/ Helm chart for production deployments
kubernetes/ Kustomize manifests for direct kubectl deployments
.github/ CI/CD workflows
```
---
## License
[LICENSE](LICENSE)