(Translated by https://www.hiragana.jp/)
GitHub - ivanlhz/pokeqwik: Simple aplication using #qwik #pokeapi #tailwind #TDD
Skip to content

ivanlhz/pokeqwik

Repository files navigation

PokeQwik App ⚡️

PokeQwik is a web application designed to showcase the first 150 Pokemon in a paginated format, displaying 30 Pokemon per page. The application is built using the Qwik framework, which provides a fast and efficient rendering system for web applications.

TODO List

  • Add integration tests Vitest?
  • Add e2e test using Cypress
  • Implement a search bar
  • Add pokemon types
  • Add filter by type
  • Improve UI and UX

Technologies Used:

  • Qwik Framework: Qwik is chosen for its efficiency in rendering and providing a seamless user experience. It follows a component-based architecture, allowing for the easy organization of different parts of the application.

  • TailwindCSS + DaisyUI: The application leverages the power of TailwindCSS for styling, ensuring a responsive and visually appealing design. The addition of DaisyUI, a component library for TailwindCSS, aids in building UI components more quickly and with consistency.

Pagination:

The Pokemon list is presented in a paginated manner to enhance user navigation. Users can smoothly move through the pages, with each page containing details about 30 Pokemon. This ensures a manageable and organized presentation of information.

Deployment:

For seamless deployment and hosting, Vercel is utilized. Vercel provides a platform for deploying web applications with ease, offering a fast and reliable hosting solution. This allows users to access the Pokemon Explorer from anywhere with an internet connection.

Domain-Driven Design (DDD):

The application adheres to the fundamental concepts of Domain-Driven Design (DDD). It organizes its codebase based on the business domain, ensuring that the structure of the code aligns with the underlying problem domain. This approach enhances maintainability and scalability by creating a clear separation of concerns.

Purpose:

PokemonQwik is not just a visual showcase but also a demonstration of how modern web technologies, frameworks, and design principles can be combined to create a performant and user-friendly application.

Explore the Pokemon world effortlessly with Pokemon Explorer, where the charm of the first 150 Pokemon meets cutting-edge web development.


Extra Information

Qwik City App

Project Structure

This project is using Qwik with QwikCity. 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.

Inside your project, you'll see the following directory structure:

├── public/
│   └── ...
└── src/
    ├── 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 for more info.

  • 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 for more info.

Add Integrations and deployment

Use the bun qwik add command to add additional integrations. Some examples of integrations includes: Cloudflare, Netlify or Express Server, and the Static Site Generator (SSG).

bun qwik add # or `bun qwik add`

Development

Development mode uses Vite's development server. The dev command will server-side render (SSR) the output during development.

npm start # or `bun 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.

bun preview # or `bun 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.

bun build # or `bun build`
Vercel Edge This starter site is configured to deploy to [Vercel Edge Functions](https://vercel.com/docs/concepts/functions/edge-functions), which means it will be rendered at an edge location near to your users.

Installation

The adaptor will add a new vite.config.ts within the adapters/ directory, and a new entry file will be created, such as:

└── adapters/
    └── vercel-edge/
        └── vite.config.ts
└── src/
    └── entry.vercel-edge.tsx

Additionally, within the package.json, the build.server script will be updated with the Vercel Edge build.

Production build

To build the application for production, use the build command, this command will automatically run npm run build.server and npm run build.client:

npm run build

Read the full guide here

Dev deploy

To deploy the application for development:

npm run deploy

Notice that you might need a Vercel account in order to complete this step!

Production deploy

The project is ready to be deployed to Vercel. However, you will need to create a git repository and push the code to it.

You can deploy your site to Vercel either via a Git provider integration or through the Vercel CLI.

About

Simple aplication using #qwik #pokeapi #tailwind #TDD

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published