react-vite

Täydellinen käyttöönottoopas react-vite -kehykselle NStrimissä

Yleiskatsaus

React Vite on moderni React-asennus, joka käyttää Viteä rakennustyökaluna. Se tarjoaa salamannopean kehityksen Hot Module Replacement (HMR) -ominaisuudella, optimoidut tuotantorakennukset ja modernin kehityskokemuksen React 19:llä.

Ennen aloittamista
Varmista, että sinulla on hallintapaneeli auki - tarvitset siellä näkyvät Git-tunnukset. Tämä malli sisältää Tailwind CSS 4:n, Redux Toolkitin, React Routerin ja Framer Motionin.

Pikaopas

1

Luo repositorio mallista

Siirry kojelaudallasi Tools & Deployment -välilehteen. Napsauta "New Repository" -painiketta, valitse React Vite -malli pudotusvalikosta, anna arkiston nimi ja alidomain ja napsauta "Create Repository".

2

Kloonaa repositorio

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
3

Asenna riippuvuudet

npm install
4

Käynnistä kehityspalvelin

npm run dev

Avaa http://localhost:4200 selaimessasi.

5

Rakenna ja lähetä

npm run build
git add .
git commit -m "Initial setup"
git push origin main
Jokainen Git-push käynnistää automaattisesti sovelluksesi käyttöönoton. Tarkista moduulisi työ-URL hallintapaneelista nähdäksesi live-sivustosi.

Paikallinen kehitys Dockerilla

Jos sinulla ei ole Node.js:ää asennettuna paikallisesti, voit käyttää Dockeria React-komentojen suorittamiseen. Projekti sisältää Dockerfilen tuotantorakennuksille nginx:llä.

Mikä on Docker?
Docker luo eristettyjä "kontteja", joissa on kaikki tarvitsemasi ohjelmistot (Node.js, npm) ilman, että niitä tarvitsee asentaa tietokoneellesi. Ajattele sitä kevyenä virtuaalikoneena.

Vaatimukset

Asenna Docker Desktop käyttöjärjestelmällesi (Windows, Mac tai Linux).

Komentojen suorittaminen Dockerilla

# Suorita npm install
docker run --rm -v $(pwd):/app -w /app node:lts-alpine npm install

# Käynnistä kehityspalvelin (käytettävissä osoitteessa localhost:4200)
docker run --rm -v $(pwd):/app -w /app -p 4200:4200 node:lts-alpine npm run dev

# Rakenna tuotantoa varten
docker run --rm -v $(pwd):/app -w /app node:lts-alpine npm run build
Huomio
Docker on valinnainen paikalliseen kehitykseen. NStrim-alusta hoitaa käyttöönoton automaattisesti - tarvitset Dockeria vain, jos haluat suorittaa komentoja paikallisesti ilman Node.js:n asennusta.

Projektin rakenne

Tiedostojen sijainnit:

├── src/
│   ├── App.jsx               # Juurikomponentti
│   ├── App.css               # Sovelluksen tyylit
│   ├── main.jsx              # Sovelluksen aloituspiste
│   ├── index.css             # Globaalit tyylit (Tailwind)
│   └── assets/               # Staattiset resurssit (kuvat jne.)
├── public/                   # Julkiset staattiset tiedostot
├── index.html                # HTML-aloituspiste
├── vite.config.js            # Viten konfiguraatio
├── package.json              # Riippuvuudet ja skriptit
├── nginx.conf                # Nginx-konfiguraatio tuotantoon
└── Dockerfile                # Dockerin rakennuskonfiguraatio
        

Yleiset tehtävät

Komponentin luominen

Luo .jsx-tiedostoja src/-kansioon:

// src/components/Button.jsx
export default function Button({ label, onClick }) {
  return (
    <button
      className="bg-blue-500 text-white px-4 py-2 rounded"
      onClick={onClick}
    >
      {label}
    </button>
  );
}

React Routerin käyttö

React Router on esikonfiguroitu. Lisää reitit sovellukseesi:

import { BrowserRouter, Routes, Route } from 'react-router-dom';
import Home from './pages/Home';
import About from './pages/About';

function App() {
  return (
    <BrowserRouter>
      <Routes>
        <Route path="/" element={<Home />} />
        <Route path="/about" element={<About />} />
      </Routes>
    </BrowserRouter>
  );
}

Redux Toolkitin käyttö

Redux Toolkit on esiasennettu tilanhallintaan:

import { createSlice } from '@reduxjs/toolkit';

const counterSlice = createSlice({
  name: 'counter',
  initialState: { value: 0 },
  reducers: {
    increment: (state) => { state.value += 1 },
    decrement: (state) => { state.value -= 1 },
  },
});

export const { increment, decrement } = counterSlice.actions;
export default counterSlice.reducer;

Tailwind CSS:n käyttö

Tailwind CSS 4 on esikonfiguroitu. Käytä luokkia suoraan JSX:ssä:

<div className="bg-blue-500 text-white p-4 rounded-lg">
  Hei Tailwind!
</div>

Hyödyllisiä komentoja

npm run dev Käynnistä kehityspalvelin (portti 4200)
npm run build Rakenna tuotantoa varten
npm run preview Esikatsele tuotantorakennusta paikallisesti
npm run lint Tarkista koodityyli ja virheet

Vianmääritys

npm install epäonnistuu käyttöoikeusvirheiden vuoksi

Syy: Käyttöoikeusongelmat npm-välimuistissa tai node_modules-kansiossa.

Ratkaisu: Poista node_modules-kansio ja package-lock.json, sitten suorita npm install uudelleen.

Portti 4200 on jo käytössä

Syy: Toinen prosessi käyttää porttia 4200.

Ratkaisu: Käytä eri porttia: npm run dev -- --port 3000 tai pysäytä toinen prosessi.

Moduulia ei löydy -virheet

Syy: Riippuvuuksia ei ole asennettu tai ne ovat vioittuneet.

Ratkaisu: Suorita npm install asentaaksesi kaikki riippuvuudet.

Muutokset eivät näy selaimessa

Syy: Selaimen välimuisti tai HMR ei toimi.

Ratkaisu: Pakota sivun uudelleenlataus (Ctrl+Shift+R tai Cmd+Shift+R) tai käynnistä kehityspalvelin uudelleen.

Rakentaminen epäonnistuu käyttöönoton jälkeen

Syy: Rakennusvirheet tai puuttuvat riippuvuudet.

Ratkaisu: Suorita npm run build paikallisesti ensin tarkistaaksesi virheet ennen lähetystä.

Käyttöönoton työnkulku

Joka kerta kun lähetät koodia Gitiin, sovelluksesi rakennetaan ja otetaan käyttöön automaattisesti:

Koodimuutos git push npm run build Käyttöönotto nginx:lle Tuotannossa!

Käyttöönotetun sovelluksesi URL noudattaa tätä muotoa:

https://<your-subdomain>-<repo-name>.<session-domain>

Esimerkki: https://student01-module-a.demo.nstrim.app

Lisätietoja löydät virallisesta React-dokumentaatiosta ja Vite-dokumentaatiosta.