{"id":27203746,"url":"https://github.com/servrox/1337-turbo-starter","last_synced_at":"2025-04-09T22:56:16.461Z","repository":{"id":285635713,"uuid":"953458452","full_name":"servrox/1337-turbo-starter","owner":"servrox","description":"1337 Turbo Starter is a modern full-stack Web3 monorepo powered by Turborepo, integrating the official Aptos DApp boilerplate.","archived":false,"fork":false,"pushed_at":"2025-04-05T14:50:59.000Z","size":379,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T22:56:10.383Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://1337-turbo-starter-aptos-boilerplate.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/servrox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-03-23T12:22:14.000Z","updated_at":"2025-04-05T14:51:02.000Z","dependencies_parsed_at":"2025-04-02T14:23:04.186Z","dependency_job_id":null,"html_url":"https://github.com/servrox/1337-turbo-starter","commit_stats":null,"previous_names":["servrox/turbo-bun-tailwind-starter","servrox/1337-turbo-starter"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/servrox%2F1337-turbo-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/servrox%2F1337-turbo-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/servrox%2F1337-turbo-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/servrox%2F1337-turbo-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/servrox","download_url":"https://codeload.github.com/servrox/1337-turbo-starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248125622,"owners_count":21051767,"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":"2025-04-09T22:56:15.764Z","updated_at":"2025-04-09T22:56:16.451Z","avatar_url":"https://github.com/servrox.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 1337 Turbo Starter – Modern Web3 Development Stack\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/bun?color=000000\u0026style=for-the-badge\u0026label=Bun\u0026logo=bun\" alt=\"Bun\" /\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/turbo?color=000000\u0026style=for-the-badge\u0026label=Turbo\u0026logo=vercel\" alt=\"Turbo\" /\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/next?color=000000\u0026style=for-the-badge\u0026label=Next.js\u0026logo=next.js\" alt=\"Next.js\" /\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/tailwindcss?color=000000\u0026style=for-the-badge\u0026label=Tailwind\u0026logo=tailwindcss\" alt=\"Tailwind\" /\u003e\n  \u003cbr /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Aptos-000000?style=for-the-badge\u0026logo=aptos\" alt=\"Aptos\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Move-000000?style=for-the-badge\u0026logo=move\" alt=\"Move\" /\u003e\n\u003c/div\u003e\n\n---\n\n## 🚀 Overview\n\n**1337 Turbo Starter** is a modern full-stack Web3 monorepo powered by [Turborepo](https://turbo.build/), integrating the official [Aptos DApp boilerplate](https://learn.aptoslabs.com/en/dapp-templates/boilerplate-template).\n\nIt runs:\n\n- ⚡️ Bun for ultra-fast performance  \n- 🎨 Tailwind CSS + shadcn/ui for polished UIs  \n- 🔗 Aptos \u0026 Move for next level Web3  \n- 🧱 Shared configs \u0026 UI across apps  \n- 🦪 Developer-first tooling and monorepo structure  \n\n---\n\n## 🧰 Tech Stack\n\n- **Bun** – Ultra-fast JS runtime \u0026 package manager  \n- **Turborepo** – High-performance monorepo build system  \n- **Next.js** – React framework for production apps  \n- **Tailwind CSS** – Utility-first CSS framework  \n- **Aptos** – Layer 1 blockchain platform  \n- **Move** – Safe, resource-oriented smart contract language  \n\n---\n\n## 📁 Project Structure\n\n```txt\n.\n├── apps/\n│   ├── aptos-boilerplate/  # Aptos DApp implementation\n│   └── landing-page/       # Landing page application\n├── packages/\n│   ├── contract/          # Move smart contracts\n│   ├── ui/                # Shared UI components\n│   ├── typescript-config/ # Shared TypeScript settings\n│   └── eslint-config/     # Shared ESLint rules\n└── .vscode/               # VS Code configuration\n```\n\n📦 **Shared packages** ensure consistent styling, types, and components across all applications.\n\n---\n\n## ⚙️ Getting Started\n\n### Prerequisites\n\n- [Bun](https://bun.sh) ≥ 1.2.5  \n- [VS Code](https://code.visualstudio.com) (recommended)  \n\n### 🧪 Installation\n\n```bash\ngit clone git@github.com:servrox/1337-turbo-starter.git\ncd 1337-turbo-starter\nbun install\n```\n\n### 🔐 Environment Setup\n\n**For the Aptos DApp (`apps/aptos-boilerplate/.env`):**\n\n```env\n# Get your API key from https://build.aptoslabs.com\nNEXT_PUBLIC_APTOS_API_KEY=your_api_key_here\n```\n\n**For the Move contract (`packages/contract/.env`):**\n\n```env\nNEXT_MODULE_PUBLISHER_ACCOUNT_PRIVATE_KEY=your_private_key_here\nNEXT_PUBLIC_MODULE_ADDRESS=your_module_address_here\n```\n\n📜 `NEXT_MODULE_PUBLISHER_ACCOUNT_ADDRESS` will be set automatically when you run:\n\n```bash\nbun run move:publish\n```\n\n### ▶️ Start Dev Server\n\n```bash\nbun run dev\n```\n\n---\n\n## 📜 Scripts\n\n| Script                          | Description                                    |\n|--------------------------------|------------------------------------------------|\n| `bun run build`                | Build all apps and packages                    |\n| `bun run build:aptos-boilerplate` | Build only the Aptos boilerplate app       |\n| `bun run build:landing-page`   | Build only the landing page                    |\n| `bun run dev`                  | Start all development servers                  |\n| `bun run dev:aptos-boilerplate`| Start Aptos boilerplate development server    |\n| `bun run dev:landing-page`     | Start landing page development server         |\n| `bun run lint`                 | Run ESLint across the repo                    |\n| `bun run check-types`          | Type-check all packages and apps              |\n| `bun run format`               | Format codebase with Prettier                 |\n\n---\n\n## ✨ Bonus\n\n- ⚡️ **Fast Dev Workflow** with Bun and Turborepo  \n- 🎨 **4-way theme switcher** select between banana, dark, light and system\n- 📦 **Shared UI Components** via `@repo/ui`  \n- 🧠 **Developer Experience**: Prettier, ESLint, TypeScript, and VS Code settings out-of-the-box  \n- 💄 **Tailwind v4**: full tailwind v4 style with css only configs  \n- 📱 **shadcn/ui monorepo** using shadcn/ui components and CLI in a [monorepo](https://ui.shadcn.com/docs/monorepo#requirements)  \n- 🌐 **create-aptos-dapp** matched Aptos Move integration with the official AptosLabs boilerplate\n\n---\n\n## 🗭 Development Guidelines\n\n### Required Environment Variables\n\n| Location                    | Variable                                       | Description                                               |\n|----------------------------|------------------------------------------------|-----------------------------------------------------------|\n| `apps/aptos-boilerplate/.env`  | `NEXT_PUBLIC_APP_NETWORK`                   | The network your module is deployed to |\n| `apps/aptos-boilerplate/.env`   | `NEXT_PUBLIC_MODULE_ADDRESS`                  | **Auto-filled** by `move:publish` script                 |\n| `apps/aptos-boilerplate/.env`  | `NEXT_PUBLIC_APTOS_API_KEY`                   | Your Aptos API key from [Aptos Labs](https://build.aptoslabs.com) |\n| `packages/contract/.env`  | `NEXT_PUBLIC_APP_NETWORK`                   | The network you want to deploy your module |\n| `packages/contract/.env`   | `NEXT_MODULE_PUBLISHER_ACCOUNT_ADDRESS`       | Account address used for module publishing                 |\n| `packages/contract/.env`   | `NEXT_PUBLIC_MODULE_ADDRESS`                  | **Auto-filled** by `move:publish` script                 |\n| `packages/contract/.env`   | `NEXT_MODULE_PUBLISHER_ACCOUNT_PRIVATE_KEY`   | Private key used for module publishing                   |\n\n💡 See the `.env.example` files in each package for more details.\n\n💡 If you are using the Testnet network, you will need to fund a module publisher account manually through the faucet web view on https://aptos.dev/en/network/faucet and then fill out the `NEXT_MODULE_PUBLISHER_ACCOUNT_PRIVATE_KEY` and `NEXT_MODULE_PUBLISHER_ACCOUNT_ADDRESS` in your project .env file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fservrox%2F1337-turbo-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fservrox%2F1337-turbo-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fservrox%2F1337-turbo-starter/lists"}