Build Options
Choose the implemented path for a new starter, an existing JavaScript or TypeScript project, manual SDK wiring, or direct HTTP.
Build Options
Choose a path from what exists today. 01.software supplies the managed backend, SDK, and API contracts; it does not host or deploy your frontend.
Choose a Build Path
| Starting point | Start with | Implemented support | Credential path |
|---|---|---|---|
| New opinionated Next.js app | npm create 01-software-app@latest | Copies one currently registered Next.js starter, installs its dependencies, and offers workspace connection. It does not generate an arbitrary framework app. | Browser authorization is the recommended path. It publishes .env.local only after the secret-free scaffold and dependency installation succeed. --auth skip keeps the app on mock data without workspace credentials. |
| Existing supported JavaScript or TypeScript project | npx @01.software/init | Detects or prompts for Next.js, React with Vite, React with Webpack or CRA, vanilla browser JavaScript, Node.js/Bun/Deno, or an Edge runtime, then adds the SDK wiring supported for that target. It preserves existing files through its conflict flow. | This is a separate prompt-driven flow and does not open greenfield browser authorization. Next.js, React, Node.js/Bun/Deno, and Edge targets offer manual application credentials or a credential-free skip; React browser targets need a Publishable Key, while server-capable targets need a Publishable Key and development Secret Key. Vanilla does not prompt for keys: replace the generated inline Publishable Key placeholder using the app's own configuration convention. |
| Existing Astro, Remix, SvelteKit, or another meta-framework | npx @01.software/init for the manual guide | Astro, Remix, and SvelteKit are detected automatically. For another framework, choose Other when init asks. Init then prints package-manager-specific SDK install and client/server examples and exits without generating framework wiring. | You configure the Publishable Key and any server-only Secret Key using that framework's environment conventions. |
| Runtime where the TypeScript SDK does not fit | OpenAPI and direct HTTP | The OpenAPI document owns implemented paths, parameters, authentication, and response shapes. 01.software does not ship framework scaffolding or a pre-generated client for this path; generate one from OpenAPI or call HTTP directly. | Follow each operation's declared authentication. Browser calls use a Publishable Key plus an allowed origin; privileged server operations require the trusted credential declared by the operation. |
The creator reads its choices from the current template registry. Run the command to see the available starters instead of relying on a copied roster in this guide.
Credential Boundaries
- A Publishable Key may be used in browser code. Register every browser origin that should call the workspace.
- A Secret Key belongs only in trusted server code and server-side environment storage. Never put it in a public environment variable, browser bundle, command argument, or commit.
- A Human CLI
pat01_is not an application credential. Neither project command copies it into application environment files. - Development credentials created or entered during local setup are not production deployment credentials. Issue and rotate production credentials separately in Console when the deployed workload needs privileged server operations.
Use Authentication & Keys for the complete trust boundaries and Integrations & Keys for origin and credential ownership.
Deployment Ownership
You deploy the generated or existing project with its own framework and hosting provider. 01.software does not provide storefront hosting, a deployment adapter, or automatic production environment configuration. You are responsible for host configuration, production credentials, allowed browser origins, deployment, and verification.
After the first local call succeeds, follow the provider- and framework-neutral Deploy handoff. Its detailed Next.js procedure applies only to the Next.js paths identified there.