Melvynx/saveit.now / .agents/skills/ns-init-project
ns-init-project
VerifiedInitialize or rebrand a NowStack Mobile product. Use for repo bootstrap, product brief intake, site-config, AGENTS.md, landing, mobile copy, Convex env, and final validation.
Init Project - NowStack Mobile
<strict_order>
- Verify repo/remotes/worktree and Convex setup.
- Collect one product brief or PRD. Do not run a long questionnaire if the user already gave the idea.
- Update product context in
AGENTS.mdand shared config insite-config.ts, then mirrortitle,slug,bundleId, product ids, andauth.trustedOriginsintoconvex/siteConfig.ts. - Update visible product copy across
web-app/andmobile-app/, including onboarding images inmobile-app/app/onboarding/content.tsand the product id inmobile-app/App.storekit. 4b. Apply branding colors inmobile-app/lib/theme.ts(the single source of truth — every mobile color resolves from there). Ask whether the app wants dual theme (light + dark, ships with a switcher) or a single theme (e.g. dark-only). For single-theme apps, follow the Mono Theme procedure inreferences/theming.mdso the switcher is removed and only one scheme is maintained — never hand-edit scattered hex. - Configure backend runtime env in Convex only; never commit secrets. At minimum set
RESEND_API_KEY,EMAIL_FROM,BETTER_AUTH_SECRET,SITE_URL(sign-in is broken without them). - If the user plans store builds, run
cd mobile-app && eas initand copy the project id intosite-config.ts > easProjectId; set prod Convex URLs inmobile-app/eas.json. - Validate changed surfaces with
npm run check-setupplus the build checks, and summarize remaining manual steps fromdocs/production-checklist.md. </strict_order>
<config_targets> Read these before editing config or branding:
sed -n '1,240p' site-config.ts
sed -n '1,220p' AGENTS.md
rg -n "NowStack|nowts|boilerplate|TODO|SaaS" web-app mobile-app convex docs site-config.ts package.json
Update only values grounded in the product brief. Do not invent legal company, domain, pricing, store ids, or OAuth credentials. </config_targets>
<env_groups> Ask by service group, not one variable at a time:
- Base/Auth:
SITE_URL,BETTER_AUTH_SECRET, trusted origins, OAuth client ids/secrets. - Email:
RESEND_API_KEY, sender/contact values. - Payments: Stripe for web/Android, Apple IAP metadata for iOS, matching
site-config.ts. - Files/R2: target names used by
convex/storage/r2.ts, normallyR2_ENDPOINT,R2_ACCESS_KEY_ID,R2_SECRET_ACCESS_KEY,R2_BUCKET_NAME,R2_PUBLIC_URL.
Set server-side runtime values in Convex:
npx convex env set KEY "value"
npx convex env list
</env_groups>
npm run check-setup
Then run only the checks that match touched surfaces:
npx convex dev --once
cd web-app && npm run typecheck
cd web-app && npm run build
cd mobile-app && npx tsc --noEmit
cd mobile-app && npm run lint
<stop_gates> Stop and ask when:
- GitHub/Convex authentication requires a browser/login prompt.
- Product brief is missing or too vague to update config.
- Secrets or live payment/store operations are required.
- The worktree contains unrelated changes that would be staged/committed. </stop_gates>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 465k | Updated | Claude CodeCodex | Unverified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 465k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |