{"id":13470999,"url":"https://github.com/Wasmswap/wasmswap-interface","last_synced_at":"2025-03-26T13:30:43.401Z","repository":{"id":37890907,"uuid":"396530176","full_name":"Wasmswap/wasmswap-interface","owner":"Wasmswap","description":null,"archived":false,"fork":false,"pushed_at":"2023-02-15T19:46:01.000Z","size":13927,"stargazers_count":26,"open_issues_count":24,"forks_count":67,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-30T02:58:01.623Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Wasmswap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-08-15T23:19:37.000Z","updated_at":"2024-10-04T04:57:06.000Z","dependencies_parsed_at":"2024-01-18T20:29:02.184Z","dependency_job_id":null,"html_url":"https://github.com/Wasmswap/wasmswap-interface","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wasmswap%2Fwasmswap-interface","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wasmswap%2Fwasmswap-interface/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wasmswap%2Fwasmswap-interface/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wasmswap%2Fwasmswap-interface/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wasmswap","download_url":"https://codeload.github.com/Wasmswap/wasmswap-interface/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245662709,"owners_count":20652068,"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","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":[],"created_at":"2024-07-31T16:00:38.342Z","updated_at":"2025-03-26T13:30:41.546Z","avatar_url":"https://github.com/Wasmswap.png","language":"TypeScript","readme":"## Wasmswap interface\n\nAn open-source interface for a CosmWasm decentralized exchange.\n\nRun the app in dev mode locally.\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\nAccess the app on `http://localhost:3000/`.\n\n## Configuration\n\nThe app configuration, feature flags, etc., is located in the .env config file.\n\nTo configure the app, you will need to swap the demo example configuration set with your chain information and add your tokens and ibc assets information.\n\n### Chain configuration\n\nSwap our test chain info example with your configuration to suggest your chain for Keplr and allow the wallet to be used in the app. It expects to receive data in the `ChainInfo` format. Refer to [Keplr documentation](https://docs.keplr.app/api/suggest-chain.html) for more information.\n\n\u003e Keplr's 'suggest chain' feature allows front-ends to add new Cosmos-SDK based blockchains that are not natively supported.\n\nUse this `env` variable to update the chain info path. The app will dynamically load the configuration so that the path can point to a local file in `/public` or a url.\n\n```\nLocal\n\nNEXT_PUBLIC_CHAIN_INFO_URL=/chain_info.testnet.json\n```\n\n```\nUrl\n\nNEXT_PUBLIC_CHAIN_INFO_URL=https://raw.githubusercontent.com/Wasmswap/asset-list-example/main/chain_info.json\n```\n\n### Provide token configuration\n\nYou will need to provide a token list json file for the available assets. By default, the platform has example tokens based on the Juno Uni-1 testnet. Refer to the token list [example](https://github.com/Wasmswap/wasmswap-interface/blob/develop/public/token_list.testnet.json) for more information.\n\nSimilarly to `NEXT_PUBLIC_CHAIN_INFO_URL` variable, the config will be loaded dynamically.\n\n```\nLocal\n\nNEXT_PUBLIC_TOKEN_LIST_URL=/token_list.testnet.json\n```\n\n```\nUrl\n\nNEXT_PUBLIC_TOKEN_LIST_URL=https://raw.githubusercontent.com/Wasmswap/asset-list-example/main/token_list.json\n```\n\n### Provide IBC assets configuration\n\nBy default, the platform only renders the example IBC assets. To allow for interchain asset transfers you will need to provide your ibc tokens lists. Refer to the ibc asset configuration [example](https://github.com/Wasmswap/wasmswap-interface/blob/develop/public/ibc_assets.json) for more information.\n\nSimilarly to `NEXT_PUBLIC_CHAIN_INFO_URL` \u0026 `NEXT_PUBLIC_TOKEN_LIST_URL` variables, the config will be loaded dynamically.\n\n```\nLocal\n\nNEXT_PUBLIC_IBC_ASSETS_URL=/ibc_assets.json\n```\n\n```\nUrl\n\nNEXT_PUBLIC_IBC_ASSETS_URL=https://raw.githubusercontent.com/Wasmswap/asset-list-example/main/ibc_assets.json\n```\n\n## Branding configuration\n\n### App name\n\nBy default, the app uses the `Wasmswap` name. To update the app name, go to the `.env` file and change the following variable:\n\n```\nNEXT_PUBLIC_SITE_TITLE=Wasmswap\n```\n\nThat will change the site title and update the footer.\n\n### Demo mode\n\nBy default, the app renders demo mode warning to warn the users that the app runs in a demo/simulation mode. If you'd like to disable the demo mode, update this env variable:\n\n```\nNEXT_PUBLIC_TEST_MODE_DISABLED=false\n```\n\n### App version\n\nUpdate this variable if you choose to run a different version.\n\n```\nNEXT_PUBLIC_APP_VERSION=1.0.0\n```\n\n### Branding\n\nWe rcommend vector graphics for your project's logo and name. Go to `/icons/Logo.tsx` and swap our branded logo symbol with yours to update the app logo.\n\nGo to `/icons/LogoText.tsx` and update the file accordingly to update the logo text.\n\n### Color palette\n\nTo update the color palette, go to `components/theme.ts` and provide your custom values.\n\n### Typography and buttons\n\n#### Font\n\nTo swap the font, navigate to `components/theme.ts` and update the font family tokens. Don't forget to connect your fonts. Refer to `styles/globals.scss` for an example.\n\n#### Color palette\n\nUpdate your project colors in the same file by updating the color tokens, and values for `textColors`, `iconColors`, `backgroundColors`, `borderColors`. It's important to keep color tokens in one space as we're planning on supporting dark \u0026 sepia modes in the future.\n\n#### Buttons\n\nTo update the styling for buttons go to `components/Button.tsx` and provide your custom styling for the variants we use.\n\n#### Typography\n\nTo update the typography component configuration, go to `components/Text.tsx` and provide your custom styling for our variants.\n\n## How to deploy\n\nThis is a nextjs app; thus everything that a nextjs app supports for deployment technically is supported by `wasmswap-interface`. We would recommend looking into Vercel.\n\n## Contributing\n\nRaise the bar for Web 3.0 with us! We would love you to contribute. Submit your PR contributions and issues directly on this repo.\n\n## License\n\nWasmswap interface is licensed under Apache 2.0.\n","funding_links":[],"categories":["UI"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWasmswap%2Fwasmswap-interface","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWasmswap%2Fwasmswap-interface","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWasmswap%2Fwasmswap-interface/lists"}