feat: add readme qwik
This commit is contained in:
@@ -1,65 +1,26 @@
|
|||||||
# Qwik City App ⚡️
|
# Qwikjs Example
|
||||||
|
|
||||||
- [Qwik Docs](https://qwik.dev/)
|
This repository contains an example of Qwikjs application that is deployed on Dokploy.
|
||||||
- [Discord](https://qwik.dev/chat)
|
|
||||||
- [Qwik GitHub](https://github.com/QwikDev/qwik)
|
|
||||||
- [@QwikDev](https://twitter.com/QwikDev)
|
|
||||||
- [Vite](https://vitejs.dev/)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Project Structure
|
1. **Use Git Provider in Your Application**:
|
||||||
|
- Repository: `https://github.com/Dokploy/examples.git`
|
||||||
|
- Branch: `main`
|
||||||
|
- Build path: `/qwik-simple`
|
||||||
|
|
||||||
This project is using Qwik with [QwikCity](https://qwik.dev/qwikcity/overview/). QwikCity is just an extra set of tools on top of Qwik to make it easier to build a full site, including directory-based routing, layouts, and more.
|
2. **Add Environment Variables**:
|
||||||
|
- Navigate to the "Environments" tab and add the following variable:
|
||||||
|
```plaintext
|
||||||
|
NIXPACKS_START_CMD="pnpm run preview"
|
||||||
|
```
|
||||||
|
|
||||||
Inside your project, you'll see the following directory structure:
|
3. **Click on Deploy**:
|
||||||
|
- Deploy your application by clicking the deploy button.
|
||||||
|
|
||||||
```
|
4. **Generate a Domain**:
|
||||||
├── public/
|
- Click on generate domain button.
|
||||||
│ └── ...
|
- A new domain will be generated for you.
|
||||||
└── src/
|
- You can use this domain to access your application.
|
||||||
├── components/
|
|
||||||
│ └── ...
|
|
||||||
└── routes/
|
|
||||||
└── ...
|
|
||||||
```
|
|
||||||
|
|
||||||
- `src/routes`: Provides the directory-based routing, which can include a hierarchy of `layout.tsx` layout files, and an `index.tsx` file as the page. Additionally, `index.ts` files are endpoints. Please see the [routing docs](https://qwik.dev/qwikcity/routing/overview/) for more info.
|
|
||||||
|
If you need further assistance, join our [Discord server](https://discord.com/invite/2tBnJ3jDJc).
|
||||||
- `src/components`: Recommended directory for components.
|
|
||||||
|
|
||||||
- `public`: Any static assets, like images, can be placed in the public directory. Please see the [Vite public directory](https://vitejs.dev/guide/assets.html#the-public-directory) for more info.
|
|
||||||
|
|
||||||
## Add Integrations and deployment
|
|
||||||
|
|
||||||
Use the `npm run qwik add` command to add additional integrations. Some examples of integrations includes: Cloudflare, Netlify or Express Server, and the [Static Site Generator (SSG)](https://qwik.dev/qwikcity/guides/static-site-generation/).
|
|
||||||
|
|
||||||
```shell
|
|
||||||
npm run qwik add # or `yarn qwik add`
|
|
||||||
```
|
|
||||||
|
|
||||||
## Development
|
|
||||||
|
|
||||||
Development mode uses [Vite's development server](https://vitejs.dev/). The `dev` command will server-side render (SSR) the output during development.
|
|
||||||
|
|
||||||
```shell
|
|
||||||
npm start # or `yarn start`
|
|
||||||
```
|
|
||||||
|
|
||||||
> Note: during dev mode, Vite may request a significant number of `.js` files. This does not represent a Qwik production build.
|
|
||||||
|
|
||||||
## Preview
|
|
||||||
|
|
||||||
The preview command will create a production build of the client modules, a production build of `src/entry.preview.tsx`, and run a local server. The preview server is only for convenience to preview a production build locally and should not be used as a production server.
|
|
||||||
|
|
||||||
```shell
|
|
||||||
npm run preview # or `yarn preview`
|
|
||||||
```
|
|
||||||
|
|
||||||
## Production
|
|
||||||
|
|
||||||
The production build will generate client and server modules by running both client and server build commands. The build command will use Typescript to run a type check on the source code.
|
|
||||||
|
|
||||||
```shell
|
|
||||||
npm run build # or `yarn build`
|
|
||||||
```
|
|
||||||
|
|||||||
Reference in New Issue
Block a user