https://github.com/simtabi/sange
Sange is a modular automation toolkit built on lightweight scripting. From Git workflows to Docker and Laravel tooling, it simplifies development—powered by Makefiles, Bash, and more to come.
https://github.com/simtabi/sange
Last synced: 5 months ago
JSON representation
Sange is a modular automation toolkit built on lightweight scripting. From Git workflows to Docker and Laravel tooling, it simplifies development—powered by Makefiles, Bash, and more to come.
- Host: GitHub
- URL: https://github.com/simtabi/sange
- Owner: simtabi
- Created: 2025-03-27T21:53:03.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-27T23:00:57.000Z (about 1 year ago)
- Last Synced: 2025-04-06T04:37:14.951Z (about 1 year ago)
- Language: Makefile
- Homepage: https://sange.sh
- Size: 2.78 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
Sange
Lightweight, modular dev automation for mono-repos—built for speed,
consistency, and happier developers.
# 🐘 Sange – Developer Automation Toolkit — WIP
**Sange** is a modular, extensible automation toolkit powered by **Makefiles** and **Bash**.
It helps streamline repetitive development tasks like Git workflows, Docker commands, Laravel tooling, and more.
**Sange**—named after the nimble and resilient *Elephant Shrew*—is designed for teams that demand **lightweight, dependable DevOps workflows**. Whether you’re working with **mono-repos, microservices, or full-stack systems**, Sange scales with precision and power.
---
## 🚀 Why Sange?
- ✅ Designed for **mono-repos** and **multi-project environments**
- ⚙️ Uses Make + Bash — no extra binaries or dependencies
- 🧩 Stack-based and extensible: Laravel, Docker, NPM, and more
- 💡 Built with modularity, readability, and reusability in mind
---
## 📚 Documentation
Each stack has its own documentation:
- 🔗 [Git Commands](./docs/git.md)
- 🐳 [Docker Commands](./docs/docker.md)
- 📦 [NPM/Yarn Commands](./docs/npm.md)
- ⚙️ [Laravel Commands](./docs/laravel.md)
- 🐍 [Python Stack (Optional)](./docs/python.md)
- 🧰 [Makefile Generator](./docs/makefile-generator.md)
---
## 🧩 Directory Structure
```
sange/
├── .github/ # GitHub workflows, issue templates, etc.
├── docs/ # Stack-specific documentation
│ ├── git.md
│ ├── docker.md
│ ├── npm.md
│ ├── laravel.md
│ ├── python.md
│ └── makefile-generator.md
│ └── ...
├── src/
│ ├── configs/ # Global variables and config defaults
│ ├── makefiles/ # Core and stack-specific Makefiles
│ │ ├── supports/ # Generators, initializers, shared logic
│ │ ├── docker.mk
│ │ ├── git.mk
│ │ ├── npm.mk
│ │ ├── laravel.mk
│ │ ├── ...
│ ├── scripts/ # Helper shell scripts (git.sh, sange.sh, etc.)
│ └── sange.mk # Master Makefile entry point
├── templates/ # Makefile scaffolding templates
│ └── makefile.template
└── README.md # This file
```
---
## 🛠️ Installation
```bash
git clone https://github.com/simtabi/sange.git
cd sange
```
Then, include the core Makefile in your project-specific `makefile`:
```makefile
# Example project Makefile
GIT_REPO := $(CURDIR)
DEFAULT_COMMIT_MESSAGE := '📦 chore(my-app): update'
include path/to/sange/src/sange.mk
```
---
## 🧠 Philosophy
Sange is designed to **help teams automate without overengineering**:
- No lock-in
- No dependencies
- Easy to audit
- Easy to extend
- Made for both beginners and power users
---
## 📝 License
MIT © Simtabi