1# Deploy an app or website | Codex use cases1---
2 2name: Deploy an app or website
3Codex use cases3tagline: Build or update a web app, deploy a preview, and get a live URL.
4 4summary: Use Codex with Build Web Apps and Vercel to turn a repo, screenshot,
55 design, or rough app idea into a working preview deployment you can share.
6 6skills:
77 - token: build-web-apps
8 8 url: https://github.com/openai/plugins/tree/main/plugins/build-web-apps
9Codex use case9 description: Build, review, and prepare web apps with React, UI, deployment,
10 10 payments, and database guidance.
11# Deploy an app or website11 - token: vercel
12 12 url: https://github.com/openai/plugins/tree/main/plugins/vercel
13Build or update a web app, deploy a preview, and get a live URL.13 description: Deploy previews, inspect deployments, read build logs, and manage
14 14 Vercel project settings.
15Difficulty **Intermediate**15bestFor:
16 16 - Turning a screenshot, map, design brief, or rough app idea into a working
17Time horizon **30m**17 web preview
18 18 - Deploying a branch or local app without manually wiring Vercel commands
19Use Codex with Build Web Apps and Vercel to turn a repo, screenshot, design, or rough app idea into a working preview deployment you can share.19 - Sharing a live URL after Codex runs the build and checks the deployment
20 20starterPrompt:
21## Best for21 title: Build and Deploy a Preview
22 22 body: >-
23- Turning a screenshot, map, design brief, or rough app idea into a working web preview23 Use @build-web-apps to turn [repo, screenshot, design, or rough app idea]
24- Deploying a branch or local app without manually wiring Vercel commands24 into a working website.
25- Sharing a live URL after Codex runs the build and checks the deployment25
26 26
27# Contents27 Then use @vercel to deploy a preview and hand me the live URL.
28 28
29[← All use cases](https://developers.openai.com/codex/use-cases)29
30 30 Context:
31Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/deploy-app-or-website/?export=pdf)31
32 32 - [what the site should do]
33Use Codex with Build Web Apps and Vercel to turn a repo, screenshot, design, or rough app idea into a working preview deployment you can share.33
34 34 - [source data, API, docs, or assets to use]
35Intermediate35
36 36 - [style or product constraints]
3730m37
38 38 - [anything not to change]
39Related links39
40 40
41[Build Web Apps plugin](https://github.com/openai/plugins/tree/main/plugins/build-web-apps) [Vercel plugin](https://github.com/openai/plugins/tree/main/plugins/vercel) [Vercel deployments](https://vercel.com/docs/deployments/overview)41 Before you hand it back, run the local build and verify the deployment is
42 42 ready.
43## Best for43 suggestedEffort: medium
44 44relatedLinks:
45- Turning a screenshot, map, design brief, or rough app idea into a working web preview45 - label: Build Web Apps plugin
46- Deploying a branch or local app without manually wiring Vercel commands46 url: https://github.com/openai/plugins/tree/main/plugins/build-web-apps
47- Sharing a live URL after Codex runs the build and checks the deployment47 - label: Vercel plugin
48 48 url: https://github.com/openai/plugins/tree/main/plugins/vercel
49## Skills & Plugins49 - label: Vercel deployments
50 50 url: https://vercel.com/docs/deployments/overview
51- [Build Web Apps](https://github.com/openai/plugins/tree/main/plugins/build-web-apps)51---
52
53 Build, review, and prepare web apps with React, UI, deployment, payments, and database guidance.
54- [Vercel](https://github.com/openai/plugins/tree/main/plugins/vercel)
55
56 Deploy previews, inspect deployments, read build logs, and manage Vercel project settings.
57
58| Skill | Why use it |
59| --- | --- |
60| [Build Web Apps](https://github.com/openai/plugins/tree/main/plugins/build-web-apps) | Build, review, and prepare web apps with React, UI, deployment, payments, and database guidance. |
61| [Vercel](https://github.com/openai/plugins/tree/main/plugins/vercel) | Deploy previews, inspect deployments, read build logs, and manage Vercel project settings. |
62
63## Starter prompt
64
65Use @build-web-apps to turn [repo, screenshot, design, or rough app idea] into a working website.
66Then use @vercel to deploy a preview and hand me the live URL.
67Context:
68- [what the site should do]
69- [source data, API, docs, or assets to use]
70- [style or product constraints]
71- [anything not to change]
72Before you hand it back, run the local build and verify the deployment is ready.
73
74Open in the Codex app
75
76Use @build-web-apps to turn [repo, screenshot, design, or rough app idea] into a working website.
77Then use @vercel to deploy a preview and hand me the live URL.
78Context:
79- [what the site should do]
80- [source data, API, docs, or assets to use]
81- [style or product constraints]
82- [anything not to change]
83Before you hand it back, run the local build and verify the deployment is ready.
84 52
85## Start with the site and the deploy target53## Start with the site and the deploy target
86 54
90 58
91Use `@build-web-apps` when Codex needs to build or polish the app. Use `@vercel` when it should deploy, inspect the deployment, or read Vercel build logs.59Use `@build-web-apps` when Codex needs to build or polish the app. Use `@vercel` when it should deploy, inspect the deployment, or read Vercel build logs.
92 60
93Use @build-web-apps to turn [repo, screenshot, design, or rough app idea] into a working website.
94Then use @vercel to deploy a preview and hand me the live URL.
95Context:
96- [what the site should do]
97- [source data, API, docs, or assets to use]
98- [style or product constraints]
99- [anything not to change]
100Before you hand it back, run the local build and verify the deployment is ready.
101
102## Check the result before you share it61## Check the result before you share it
103 62
104Codex should tell you what it changed, which command it used to build the project, and whether the Vercel deployment is ready. If the deploy needs an environment variable, team choice, domain setting, or login step, Codex should call that out instead of pretending the site is finished.63Codex should tell you what it changed, which command it used to build the project, and whether the Vercel deployment is ready. If the deploy needs an environment variable, team choice, domain setting, or login step, Codex should call that out instead of pretending the site is finished.
107 66
108## Iterate from the live URL67## Iterate from the live URL
109 68
110Once you have the preview, keep the same thread open. Ask Codex to open the URL, fix layout issues, update copy, wire missing data, or read Vercel logs if the deploy fails. The thread already has the repo, deployment, and build context.69Once you have the preview, keep the same task open. Ask Codex to open the URL, fix layout issues, update copy, wire missing data, or read Vercel logs if the deploy fails. The task already has the repo, deployment, and build context.
111 70
112Good follow-ups are specific:71Good follow-ups are specific:
113 72
114- “The mobile layout is cramped. Fix it and redeploy the preview.”73- "The mobile layout is cramped. Fix it and redeploy the preview."
115- “Use the same project and add the latest data from [source].”74- "Use the same project and add the latest data from [source]."
116- “Read the failed build logs and fix the deploy.”75- "Read the failed build logs and fix the deploy."
117
118## Related use cases
119
120[
121
122### Build and deploy internal apps
123
124Use Codex with Sites to build, test, and deploy internal apps, with built-in storage and...
125
126Front-end Integrations](https://developers.openai.com/codex/use-cases/build-and-deploy-internal-apps)[
127
128### Get from idea to proof of concept
129
130Use Codex with ImageGen to turn a rough idea into a visual direction, implement the smallest...
131
132Front-end Engineering](https://developers.openai.com/codex/use-cases/idea-to-proof-of-concept)[
133
134### Make granular UI changes
135
136Use Codex to make one small UI adjustment at a time in an existing app, verify it in the...
137
138Front-end Design](https://developers.openai.com/codex/use-cases/make-granular-ui-changes)
139