aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar BanceDev 2026-02-28 15:03:07 -0500
committerGravatar BanceDev 2026-02-28 15:03:07 -0500
commit0b3b366635307b18bf2216032bfdeba496760428 (patch)
tree1a5bc593d2e953299440559c2654dee0201cc9f6
parentdon't send update prompt if no new packages (diff)
public facing readme
-rw-r--r--README.md60
-rw-r--r--TODO9
-rw-r--r--logo.pngbin0 -> 4017 bytes
3 files changed, 26 insertions, 43 deletions
diff --git a/README.md b/README.md
index d61d002..98742bb 100644
--- a/README.md
+++ b/README.md
@@ -1,46 +1,30 @@
-# Package Manager
+<p align="center">
+ <img width="256" height=auto src="logo.png">
+ <br/>
+ <img src="https://img.shields.io/github/contributors/bancedev/forge" alt="contributors">
+ <img src="https://img.shields.io/github/license/bancedev/forge" alt="license">
+ <img src="https://img.shields.io/github/forks/bancedev/forge" alt="forks">
+</p>
-## Usage
+---
-forge add <repo>
+# Forge
-creates a config for the package based on the repo name.
+Forge is a from-source package manager that allows for the seamless tracking, installing, and updating of packages build from git repositories. Forge is entirely independent of any upstream repository project you only need a git repo with the source code.
-#TODO: handle namespace conflict
+Forge is mostly designed to be used alongside an operating system with existing package managers like Arch Linux or Debian Linux with forge acting as a simple tool to supplement packages that don't exist or give user freedom to use from-source compilation to optimize performance on certain applications. At this point in time forge has no concept of a dependency tree for the packages it tracks but it may at some point in the future.
-config options:
+---
-update = <no, live, tagged>
-build = "build command"
-install = "install command"
-uninstall = "uninstall command"
-clean = "clean command"
-deps = ["named list of deps"]
+## Compiling/Installation
-forge update
+Forge uses [just](https://github.com/casey/just) to simplify build and install.
+```
+just
+sudo just install
+```
-pulls latest for all tracked packages per update rules
-
-forge upgrade [pkgnames]
-
-If no names are provided assume all otherwise do build and install on named packages
-
-forge remove [pkgnames]
-
-Removes named packages and orphaned deps
-
-forge list
-
-lists all packages currently tracked
-
-forge search [term]
-
-lists packages with the given substring not case sensitive
-
-forge clean [pkgnames]
-
-runs the clean command on every tracked package or named
-
-forge show [pkgname]
-
-shows the configured info about the package
+Then you can bootstrap forge to track itself by doing.
+```
+sudo forge add https://git.bance.dev/forge.git
+```
diff --git a/TODO b/TODO
index 1660a35..950c04d 100644
--- a/TODO
+++ b/TODO
@@ -1,5 +1,4 @@
-branch in config
-hash in config
-Add config command to set forge's values like the editor
-Implement Search
-make helper function for collecting package info
+repo branch in config
+repo set hash
+tagged and none update modes
+lockfile for update tracking
diff --git a/logo.png b/logo.png
new file mode 100644
index 0000000..aeb5c6a
--- /dev/null
+++ b/logo.png
Binary files differ