{"id":14530747,"url":"https://github.com/tez-capital/tea","last_synced_at":"2026-04-18T09:44:41.310Z","repository":{"id":104050380,"uuid":"532602336","full_name":"tez-capital/tea","owner":"tez-capital","description":"Tezos contract development Environment by alis.is","archived":false,"fork":false,"pushed_at":"2025-06-18T22:04:14.000Z","size":262,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-18T22:33:37.637Z","etag":null,"topics":["dapp","docker","ligo","smart-contracts","taquito","tezos"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tez-capital.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-04T16:59:24.000Z","updated_at":"2025-06-18T22:04:18.000Z","dependencies_parsed_at":"2025-02-04T06:12:04.997Z","dependency_job_id":null,"html_url":"https://github.com/tez-capital/tea","commit_stats":null,"previous_names":["alis-is/tea"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/tez-capital/tea","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tez-capital%2Ftea","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tez-capital%2Ftea/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tez-capital%2Ftea/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tez-capital%2Ftea/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tez-capital","download_url":"https://codeload.github.com/tez-capital/tea/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tez-capital%2Ftea/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273219922,"owners_count":25066262,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-02T02:00:09.530Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dapp","docker","ligo","smart-contracts","taquito","tezos"],"created_at":"2024-09-05T00:01:09.665Z","updated_at":"2026-04-18T09:44:41.261Z","avatar_url":"https://github.com/tez-capital.png","language":"Lua","funding_links":[],"categories":["Development Tools"],"sub_categories":["Social Media"],"readme":"# TEA \n\u003cp align=\"center\"\u003e\u003cimg width=\"100\" src=\"https://raw.githubusercontent.com/alis-is/tea/main/__tea/assets/logo.svg\" alt=\"TEA logo\"\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://raw.githubusercontent.com/alis-is/tea/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg?sanitize=true\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://discord.gg/WzqWTdD\"\u003e\u003cimg src=\"https://img.shields.io/badge/chat-on%20discord-7289da.svg?sanitize=true\" alt=\"Chat\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/alis-is/tea\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Remote%20-%20Containers\u0026message=Open\u0026color=blue\u0026logo=visualstudiocode\" alt=\"Open in Remote - Containers\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nTEA is small, adaptable and **self contained** development environment for Tezos smart contracts.\n- small - dependencies of this project alone are only ~1.2MB\n- adaptable - all behavior is determined based on [app.hjson](https://github.com/alis-is/tea/blob/main/app.hjson), can be tracked down and adjusted through [ami.lua](https://github.com/alis-is/tea/blob/main/ami.lua)\n- self contained - all features as included within - adjust them anyway you like or need\n\nStart your new Tezos project faster than you prepare cup of tea. :)\n\n## What does TEA provide?\n- **ligo** compilation and tests (*SmartPy is not supported right now but with TEA adaptability you can make it to.*)\n- **taquito** based module for dapp development\n- e2e tests with taquito and sandbox\n\n## Dependencies\n- eli and ami - for `ami` commands - only ~1.2MB\n- (optional) [podman](https://podman.io/getting-started/installation) or [docker](https://docs.docker.com/engine/install/)\n- (optional) [nodejs](https://nodejs.org/en/download/) for dapp development\n- (optional) [esy](https://esy.sh/) for access to ligo package management\n- For development on windows use [wsl2](https://docs.microsoft.com/en-us/windows/wsl/install)\n\n## Get Started\n\n### With Dev Container\n\n1. Make sure you have [docker](https://docs.docker.com/engine/install/)\nTo store repository within the container:\n2. Open dev container directly by clicking the container badge or [here](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/alis-is/tea).\nOr to store repository on local file system:\n1. Clone repository\n   - `git clone https://github.com/alis-is/tea.git`\n2. Choose `Reopen in Container` when prompted by VS Code.\n\n### Lightweight local setup\n1. Clone repository \n   - `git clone https://github.com/alis-is/tea.git`\n2. Get `eli` and `ami` (lua engines powering tea)\n   - `wget -q https://raw.githubusercontent.com/alis-is/ami/master/install.sh -O /tmp/install.sh \u0026\u0026 sh /tmp/install.sh`\n3. Install optional dependencies if needed\n4. (optional) Edit `app.hjson` to adjust template behavior\n   - **You should set id to name of your project.** (Build and deploy commands use this id to name files)\n5. `ami setup` (Downloads ligo and runs `ligo install` if needed)\n6. (optional) to develop js module run `npm install` from within the `web` directory\n7. You are ready to code\n\n**NOTE**: *TEA is fully self contained template. No behavior is specified in outside packages or set in stone. You can adjust it however you like. Just edit behavior within `__tea` directory.* ;)\n\n## Guide\n\nTEA is operated with commands through `ami`. All commands respects your configuration within `app.hjson` and are defined within `ami.lua`\n\nTEA provides bellow commands (see `--help` of each for details):\n- `ami sandbox start` start sandbox\n- `ami sandbox stop` stop sandbox\n- `ami compile` compiles contract, initial storage and views\n- `ami deploy \u003cdeploy id\u003e` deploys deploy or multiple based on id\n- `ami test` runs ligo tests (stored in `tests`)\n- `ami test-js` runs web module tests (stored in `web/tests`)\n  - *requires started sandbox*\n  - `ami test-js tests/admin.specs.js` runs `tests/admin.specs.js` tests\n\n## Sample workflow\n\n1. Code your contract\n2. Run `ami compile` to compile contract and storage (See `--help` for options or selective compilation)\n3. Run `ami test` to execute ligo tests\n4. Run `ami deploy \u003cdeploy id\u003e` to deploy contract to your deploys\n   - `ami deploy sandbox` to deploy to sandbox with default `app.hjson`\n5. Run `ami test-js` to test js-module\n\n### Debug\nYou can examine all commands tea executes with log level debug:\n   - `ami -ll=debug \u003ccommand\u003e` e.g. `ami -ll=debug test`\n\n## Development with VS Code\n\n1. Install [Lua extension from sumneko](https://marketplace.visualstudio.com/items?itemName=sumneko.lua)\n2. Run `ami download-dev-metas` to download meta definitions for autocomplete\n3. Adjust template as needed. Entire template codebase is scoped within `__tea` directory.\n\n## Projects using this template\n\n- [Starlords](https://starlords.xyz/)\n- [TzC](https://tez.capital/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftez-capital%2Ftea","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftez-capital%2Ftea","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftez-capital%2Ftea/lists"}