# TeqFW

> Tequila Framework (TeqFW) is an evolving modular JavaScript platform for web applications: Enterprise architecture. Vanilla JavaScript.

TeqFW composes applications at runtime through explicit namespaces, declared dependencies, late binding, and reusable plugins. It is a platform, not only a DI container: `@teqfw/di` is foundational and the other core packages provide complementary infrastructure. TeqFW is not an AI-agent framework; agent-readiness is a secondary benefit of explicit architecture and package contracts. ADSM is related methodology, not part of the TeqFW product. Showcase software demonstrates composition and reuse, not universal architectural superiority.

## Start here

- [TeqFW overview](https://teqfw.com/index.md) — identity, positioning, platform foundation, and composition.
- [Platform agent guide](https://teqfw.com/agent-guide.md) — orientation for changing a TeqFW application.
- [Ecosystem](https://teqfw.com/ecosystem.md) — package relationships and progressive composition.
- [Philosophy](https://teqfw.com/ecosystem/philosophy.md) — architectural principles and machine-interface boundary.
- [Showcase](https://teqfw.com/showcase.md) — factual platform, plugin, application, and product evidence.

## Task routing

- [Understand a TeqFW application](https://teqfw.com/agent-guide.md) — composition model and architectural inspection order.
- [Dependency injection and late binding](https://raw.githubusercontent.com/teqfw/di/main/skills/teqfw-di/SKILL.md) — `@teqfw/di` integration guidance.
- [Application configuration](https://raw.githubusercontent.com/teqfw/cfg/main/skills/teqfw-cfg/SKILL.md) — `@teqfw/cfg` source, loading, and lifecycle guidance.
- [Lifecycle and CLI functionality](https://raw.githubusercontent.com/teqfw/cli/main/skills/teqfw-cli/SKILL.md) — `@teqfw/cli` host and command guidance.
- [Persistence and database work](https://raw.githubusercontent.com/teqfw/db/main/skills/teqfw-db/SKILL.md) — `@teqfw/db` infrastructure guidance.
- [HTTP and web runtime work](https://raw.githubusercontent.com/teqfw/web/main/skills/teqfw-web/SKILL.md) — `@teqfw/web` request-pipeline and server guidance.

## Platform packages

- [`@teqfw/di` skill](https://raw.githubusercontent.com/teqfw/di/main/skills/teqfw-di/SKILL.md) — foundational namespace resolution, runtime composition, and late binding.
- [`@teqfw/log` skill](https://raw.githubusercontent.com/teqfw/log/main/skills/teqfw-log/SKILL.md) — logging infrastructure.
- [`@teqfw/cfg` skill](https://raw.githubusercontent.com/teqfw/cfg/main/skills/teqfw-cfg/SKILL.md) — application and plugin configuration.
- [`@teqfw/cli` skill](https://raw.githubusercontent.com/teqfw/cli/main/skills/teqfw-cli/SKILL.md) — Node.js lifecycle and CLI composition.
- [`@teqfw/db` skill](https://raw.githubusercontent.com/teqfw/db/main/skills/teqfw-db/SKILL.md) — database infrastructure.
- [`@teqfw/web` skill](https://raw.githubusercontent.com/teqfw/web/main/skills/teqfw-web/SKILL.md) — web and server runtime infrastructure.

## Examples

- [`teq-tmpl`](https://github.com/flancer32/teq-tmpl) — reusable TeqFW plugin functionality.
- [`teq-cms`](https://github.com/flancer32/teq-cms) — reusable product/plugin composed from TeqFW infrastructure and `teq-tmpl`.
- [`site_wg`](https://github.com/flancer32/site_wg) — host application using `teq-cms` and powering [wiredgeese.com](https://wiredgeese.com/).
- [`mindstream`](https://github.com/flancer32/mindstream) — structurally different database-backed TeqFW application.

## Optional

- [ADSM method](https://teqfw.com/method.md) — related methodology for directing coding-agent work.
- [Contacts](https://teqfw.com/contacts.md) — TeqFW contact and formal business details.