use-cases/deploy-app-or-website.md +138 −0 added
1# Deploy an app or website | Codex use cases
2
3Codex use cases
4
5
6
7
8
9Codex use case
10
11# Deploy an app or website
12
13Build or update a web app, deploy a preview, and get a live URL.
14
15Difficulty **Intermediate**
16
17Time horizon **30m**
18
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.
20
21## Best for
22
23- Turning a screenshot, map, design brief, or rough app idea into a working web preview
24 - Deploying a branch or local app without manually wiring Vercel commands
25 - Sharing a live URL after Codex runs the build and checks the deployment
26
27# Contents
28
29[← All use cases](https://developers.openai.com/codex/use-cases)
30
31Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/deploy-app-or-website/?export=pdf)
32
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.
34
35Intermediate
36
3730m
38
39Related links
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)
42
43## Best for
44
45- Turning a screenshot, map, design brief, or rough app idea into a working web preview
46 - Deploying a branch or local app without manually wiring Vercel commands
47 - Sharing a live URL after Codex runs the build and checks the deployment
48
49## Skills & Plugins
50
51- [Build Web Apps](https://github.com/openai/plugins/tree/main/plugins/build-web-apps)
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.
66 Then use @vercel to deploy a preview and hand me the live URL.
67 Context:
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
74[Open in the Codex app](codex://new?prompt=Use+%40build-web-apps+to+turn+%5Brepo%2C+screenshot%2C+design%2C+or+rough+app+idea%5D+into+a+working+website.%0A%0AThen+use+%40vercel+to+deploy+a+preview+and+hand+me+the+live+URL.%0A%0AContext%3A%0A-+%5Bwhat+the+site+should+do%5D%0A-+%5Bsource+data%2C+API%2C+docs%2C+or+assets+to+use%5D%0A-+%5Bstyle+or+product+constraints%5D%0A-+%5Banything+not+to+change%5D%0A%0ABefore+you+hand+it+back%2C+run+the+local+build+and+verify+the+deployment+is+ready. "Open in the Codex app")
75
76Use @build-web-apps to turn [repo, screenshot, design, or rough app idea] into a working website.
77 Then use @vercel to deploy a preview and hand me the live URL.
78 Context:
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
85## Start with the site and the deploy target
86
87Codex can build or update a website or app, run the project checks, deploy it with Vercel, and return the URL.
88
89The useful handoff is concrete: a repo, screenshot, map, design brief, product note, API doc, or data source. Codex should inspect the project before changing it, then use the Vercel plugin to deploy a preview by default.
90
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.
92
93Use @build-web-apps to turn [repo, screenshot, design, or rough app idea] into a working website.
94 Then use @vercel to deploy a preview and hand me the live URL.
95 Context:
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 it
103
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.
105
106Keep production changes explicit. A preview deployment is the default; ask for production only when you mean it.
107
108## Iterate from the live URL
109
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.
111
112Good follow-ups are specific:
113
114- "The mobile layout is cramped. Fix it and redeploy the preview."
115- "Use the same project and add the latest data from [source]."
116- "Read the failed build logs and fix the deploy."
117
118## Related use cases
119
120[
121
122### Bring your app to ChatGPT
123
124Build one narrow ChatGPT app outcome end to end: define the tools, scaffold the MCP server...
125
126Integrations Code](https://developers.openai.com/codex/use-cases/chatgpt-apps)[
127
128### Add iOS app intents
129
130Use Codex and the Build iOS Apps plugin to identify the actions and entities your app should...
131
132iOS Code](https://developers.openai.com/codex/use-cases/ios-app-intents)[
133
134### Adopt liquid glass
135
136Use Codex and the Build iOS Apps plugin to audit existing iPhone and iPad UI, replace custom...
137
138iOS Code](https://developers.openai.com/codex/use-cases/ios-liquid-glass)