Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing Deployment Examples/Dockerfile Instructions #3933

Open
suprunchuk opened this issue Jan 14, 2025 · 6 comments
Open

Missing Deployment Examples/Dockerfile Instructions #3933

suprunchuk opened this issue Jan 14, 2025 · 6 comments
Labels
enhancement New feature or request

Comments

@suprunchuk
Copy link

Is your feature request related to a problem? Please describe.

I'm always frustrated when I finish developing a Nextra site and then have to spend significant time figuring out how to deploy it. The current documentation focuses almost exclusively on development workflows, covering topics like MDX authoring, theming, and component usage. However, it completely omits any information about building for production, creating deployment artifacts, or configuring servers. This forces users to search for external resources or rely on trial and error, which is time-consuming and inefficient. This lack of deployment guidance creates a significant barrier to entry for new users and makes it harder for everyone to put their Nextra projects live.

Describe the solution you'd like

I would like the Nextra documentation to include a dedicated section on deployment. This section should provide clear and concise instructions on how to prepare a Nextra site for production. Ideally, it should include:

Building a production-ready version: Instructions on how to generate optimized static files or configure server-side rendering (if applicable).
Dockerfile examples: At least one example of a Dockerfile that demonstrates how to containerize a Nextra application for deployment.

Describe alternatives you've considered
Additional context Add any other context or screenshots about the feature
request here.

@suprunchuk suprunchuk added the enhancement New feature or request label Jan 14, 2025
@dimaMachina
Copy link
Collaborator

you can follow next.js docs about deploying https://nextjs.org/docs/app/building-your-application/deploying
Nextra is just a layer on top of your Next.js app, everything what works with next.js works with nextra

@suprunchuk
Copy link
Author

you can follow next.js docs about deploying https://nextjs.org/docs/app/building-your-application/deploying Nextra is just a layer on top of your Next.js app, everything what works with next.js works with nextra

Thank you. but I would like to mention it right here on the nextra website. I haven't found anything about it at all, not even links to the nextjs website. and even more so the dockerfile

@suprunchuk
Copy link
Author

@dimaMachina can you update this template for version 4 nextra?
I have errors when using

@dimaMachina
Copy link
Collaborator

I don't have write access to this repo, you can send your PR

@suprunchuk
Copy link
Author

Currently, there is no launch template for Nextra 4.
all the news on the Internet publishes news about Nextra 4. but there is no normal launch template for a quick launch.

@dimaMachina
Copy link
Collaborator

you can check out working examples https://github.com/shuding/nextra/tree/main/examples

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants