Hyse Comics is an application for reading comics.
- TypeScript keeps the application typed and maintainable.
- Vite and the Cloudflare Vite plugin power development and production builds for Cloudflare Workers.
- TanStack Start provides the full-stack application framework, including routing and data loading.
- React provides the user interface.
- Material UI, Embla Carousel, and Tabler Icons provide the application's components and icons.
- Vitest provides the test runner, using Browser Mode with Playwright for component and user-interaction tests in Chromium.
Follow the steps below to set up and run the project in your local environment.
Before you begin, make sure Node.js and pnpm are installed at the versions specified in .nvmrc and the packageManager field of package.json, respectively.
-
Clone the repository:
Open your terminal and run the following command:
git clone https://github.com/luckasnix/hyse-comics-web.git
-
Navigate to the project directory:
cd hyse-comics-web -
Install dependencies:
pn install --frozen-lockfile
-
Run the development server in the local Workers runtime:
pn dev
-
Open in your browser:
Open http://localhost:3001 in your browser to view the result.
Tests use Vitest with Browser Mode and Playwright for browser-dependent behavior in Chromium. Browser-independent tests run directly in Node.js.
After installing the project dependencies, install Chromium once:
pn exec playwright install chromiumRun the test suite once:
pn testStart Vitest in watch mode while developing:
pn test:watchGenerate the coverage report:
pn test:coverageBuild the Worker and its static assets:
pn buildPreview the production build in the local Workers runtime:
pn previewFor deployment validation, publishing, custom domains, and automatic deployments, see the deployment guide.
Licensed under the PolyForm Shield License 1.0.0.