@xaidenlabs/uso 1.0.3 → 1.1.0

package/README.md

@@ -75,6 +75,23 @@ uso install anchor
 
 ---
 
+---
+
+### Project Scaffolding
+
+Start a new project with a robust, pre-configured Anchor template.
+
+```bash
+uso create <project-name>
+```
+
+This generates a "batteries-included" workspace with:
+-   **Localnet Configuration**: `Anchor.toml` pre-wired for local development.
+-   **Test Suite**: A running example test file using the latest Anchor syntax.
+-   **Scripts**: NPM scripts for linting and testing.
+
+---
+
 ### Verification
 
 After installation, verify that all components are correctly configured and accessible in your system PATH.

package/bin/index.js

@@ -1,8 +1,9 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 const { program } = require('commander');
 const { init } = require('../src/commands/init');
 const { doctor } = require('../src/commands/doctor');
 const { verify } = require('../src/commands/verify');
+const { create } = require('../src/commands/create');
 const { build, test, deploy, clean } = require('../src/commands/workflow');
 const { uninstall } = require('../src/commands/uninstall');
 
@@ -27,6 +28,11 @@ program
     .description('Verify installation by building a test Anchor project')
     .action(verify);
 
+program
+    .command('create <project_name>')
+    .description('Scaffold a new Anchor project')
+    .action(create);
+
 program
     .command('build')
     .description('Build the Anchor project (wraps "anchor build")')

package/my-test-project/Anchor.toml

@@ -0,0 +1,18 @@
+[toolchain]
+
+[features]
+seeds = false
+skip-lint = false
+
+[programs.localnet]
+my_test_project = "Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS"
+
+[registry]
+url = "https://api.apr.dev"
+
+[provider]
+cluster = "Localnet"
+wallet = "~/.config/solana/id.json"
+
+[scripts]
+test = "yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/**/*.ts"

package/my-test-project/README.md

@@ -0,0 +1,36 @@
+# Welcome to Your USO Project 🚀
+
+Congratulations! You've just scaffolded a professional Solana workspace using the **Universal Solana Orchestrator (USO)**.
+
+This isn't just a folder with files. It's a battle-tested setup ready for serious development.
+
+## 📂 Structure
+- `programs/`: Your Rust smart contracts live here.
+- `tests/`: Robust TypeScript tests using Anchor.
+- `Anchor.toml`: Your project configuration.
+
+## ⚡ Quick Start
+
+### 1. Build
+Compile your smart contract:
+```bash
+anchor build
+```
+
+### 2. Test
+Run your test suite against a local validator:
+```bash
+anchor test
+```
+*Note: This automatically spins up a local validator, deploys your program, runs tests, and shuts down.*
+
+### 3. Deploy (Devnet)
+When you're ready to go public:
+1. Switch to devnet: `solana config set --url devnet`
+2. Airdrop SOL: `solana airdrop 2`
+3. Deploy: `anchor deploy`
+
+## 🧠 Need Help?
+Run `uso doctor` if your environment feels weird. Usage instructions are also available via `uso help`.
+
+Happy coding!