react-vite
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ä.
Pikaopas
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".
Kloonaa repositorio
git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
Asenna riippuvuudet
npm install
Käynnistä kehityspalvelin
npm run dev
Avaa http://localhost:4200 selaimessasi.
Rakenna ja lähetä
npm run build
git add .
git commit -m "Initial setup"
git push origin main
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ä.
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
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:
Käyttöönotetun sovelluksesi URL noudattaa tätä muotoa:
https://<your-subdomain>-<repo-name>.<session-domain>
Esimerkki: https://student01-module-a.demo.nstrim.app