Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/benjammin4dayz/neu-react-vite

A template to kickstart your Neutralino.js apps with React, Vite, and optionally TypeScript!
https://github.com/benjammin4dayz/neu-react-vite

boilerplate hot-module-replacement minimal neutralino neutralinojs reactjs template vite

Last synced: 4 days ago
JSON representation

A template to kickstart your Neutralino.js apps with React, Vite, and optionally TypeScript!

Awesome Lists containing this project

README

        

# neu-iconneu-react-vitereact-iconreact-icon

A minimal template for building Neutralino.js apps using React and Vite.

## About

This Neutralino app template features HMR _(Hot Module Replacement)_ and uses SWC _(Speedy Web Compiler)_. It can be converted to TypeScript with a single command!

### Demo

Start developing your app in _less than 30 seconds!_

## Getting Started

This template abstracts the setup process by using the [`neu` CLI][neu-cli] under the hood.

### Prerequisites

- Node.js
- npm

### Installation

1. Create a new app with `neu create`

```bash
npx @neutralinojs/neu create myapp --template benjammin4dayz/neu-react-vite
cd myapp
```

Alternative Method (Expand)

1. Clone the repo

```bash
git clone --depth=1 https://github.com/benjammin4dayz/neu-react-vite.git
cd neu-react-vite
```

2. Install dependencies

```bash
npm run setup
```

### Configuration

- Convert this template to TypeScript

```bash
node .ts-convert
```

## Usage

- Local Development

```bash
# Develop
npm start
# Build
npm run build
# Package
npm run build:release
```

[View scripts][npm-scripts]

- GitHub Actions

```bash
# Build and draft a release on GitHub:
git tag
git push origin
```

[View workflow][workflow-file]

## Troubleshooting

Before proceeding, try refreshing the page inside your app with `F5`, `CTRL + R`, or by right-clicking and selecting `Refresh`.

### Blank screen with no errors during development

Try pasting this snippet in the DevTools console tab:

```js
window.location.href = 'http://localhost:3000';
```

[neu-cli]: https://neutralino.js.org/docs/cli/neu-cli
[neu-conf]: ./neutralino.config.json
[npm-scripts]: ./package.json
[workflow-file]: .github/workflows/create-neutralinojs-app.yml