react-vite

Pilnīga izvietošanas rokasgrāmata react-vite uz NStrim

Pārskats

React Vite ir moderna React konfigurācija, kas izmanto Vite kā būvēšanas rīku. Tā piedāvā zibenīgi ātru izstrādi ar karsto moduļu aizstāšanu (HMR), optimizētas produkcijas būves un modernu izstrādes pieredzi ar React 19.

Pirms sākat
Pārliecinieties, ka jums ir atvērts informācijas panelis - jums būs nepieciešami tur parādītie Git akreditācijas dati. Šī veidne ietver Tailwind CSS 4, Redux Toolkit, React Router un Framer Motion.

Ātrais sākums

1

Izveidojiet repozitoriju no veidnes

Savā vadības panelī atveriet cilni Tools & Deployment. Noklikšķiniet uz pogas "New Repository", izvēlieties React Vite veidni no nolaižamā saraksta, ievadiet repozitorija nosaukumu un apakšdomēnu, un noklikšķiniet "Create Repository".

2

Klonējiet savu repozitoriju

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

Instalējiet atkarības

npm install
4

Palaidiet izstrādes serveri

npm run dev

Atveriet http://localhost:4200 savā pārlūkprogrammā.

5

Būvējiet un augšupielādējiet

npm run build
git add .
git commit -m "Initial setup"
git push origin main
Katrs Git push automātiski izvieto jūsu lietojumprogrammu. Pārbaudiet sava moduļa darba URL informācijas panelī, lai redzētu savu tiešsaistes vietni.

Lokālā izstrāde ar Docker

Ja jums nav lokāli instalēts Node.js, varat izmantot Docker, lai palaistu React komandas. Projekts ietver Dockerfile produkcijas būvēm ar nginx.

Kas ir Docker?
Docker izveido izolētus "konteinerus" ar visu nepieciešamo programmatūru (Node.js, npm), neinstalējot to jūsu datorā. Iedomājieties to kā vieglu virtuālo mašīnu.

Priekšnoteikumi

Instalējiet Docker Desktop savai operētājsistēmai (Windows, Mac vai Linux).

Komandu palaišana ar Docker

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

# Run development server (accessible at localhost:4200)
docker run --rm -v $(pwd):/app -w /app -p 4200:4200 node:lts-alpine npm run dev

# Build for production
docker run --rm -v $(pwd):/app -w /app node:lts-alpine npm run build
Piezīme
Docker nav obligāts lokālajai izstrādei. NStrim platforma automātiski apstrādā izvietošanu - Docker ir nepieciešams tikai tad, ja vēlaties palaist komandas lokāli bez instalēta Node.js.

Projekta struktūra

Izpratne par failu atrašanās vietām:

├── src/
│   ├── App.jsx               # Saknes komponente
│   ├── App.css               # Lietotnes specifiskie stili
│   ├── main.jsx              # Lietojumprogrammas ieejas punkts
│   ├── index.css             # Globālie stili (Tailwind)
│   └── assets/               # Statiskie resursi (attēli utt.)
├── public/                   # Publiskie statiskie faili
├── index.html                # HTML ieejas punkts
├── vite.config.js            # Vite konfigurācija
├── package.json              # Atkarības un skripti
├── nginx.conf                # Nginx konfigurācija produkcijai
└── Dockerfile                # Docker būves konfigurācija
        

Bieži veicamie uzdevumi

Komponentes izveide

Izveidojiet .jsx failus mapē src/:

// 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 Router izmantošana

React Router ir iepriekš konfigurēts. Pievienojiet maršrutus savā App:

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 Toolkit izmantošana

Redux Toolkit ir iepriekš instalēts stāvokļa pārvaldībai:

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 izmantošana

Tailwind CSS 4 ir iepriekš konfigurēts. Izmantojiet klases tieši savā JSX:

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

Noderīgas komandas

npm run dev Palaist izstrādes serveri (ports 4200)
npm run build Būvēt produkcijai
npm run preview Priekšskatīt produkcijas būvi lokāli
npm run lint Pārbaudīt koda stilu un kļūdas

Problēmu novēršana

npm install neizdodas ar atļauju kļūdām

Cēlonis: Atļauju problēmas ar npm kešatmiņu vai node_modules.

Risinājums: Izdzēsiet node_modules mapi un package-lock.json, tad palaidiet npm install vēlreiz.

Ports 4200 jau tiek izmantots

Cēlonis: Cits process izmanto portu 4200.

Risinājums: Izmantojiet citu portu: npm run dev -- --port 3000 vai apturiet citu procesu.

Modulis nav atrasts kļūdas

Cēlonis: Atkarības nav instalētas vai ir bojātas.

Risinājums: Palaidiet npm install, lai instalētu visas atkarības.

Izmaiņas neparādās pārlūkprogrammā

Cēlonis: Pārlūkprogrammas kešatmiņa vai HMR nedarbojas.

Risinājums: Veiciet cieto atsvaidzināšanu (Ctrl+Shift+R vai Cmd+Shift+R) vai restartējiet izstrādes serveri.

Būve neizdodas pēc izvietošanas

Cēlonis: Būves kļūdas vai trūkstošas atkarības.

Risinājums: Vispirms palaidiet npm run build lokāli, lai pārbaudītu kļūdas pirms augšupielādes.

Izvietošanas darbplūsma

Katru reizi, kad augšupielādējat kodu Git, jūsu lietojumprogramma tiek automātiski būvēta un izvietota:

Koda izmaiņas git push npm run build Izvietot uz nginx Tiešraidē!

Jūsu izvietotās lietojumprogrammas URL seko šim formātam:

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

Piemērs: https://student01-module-a.demo.nstrim.app

Lai iegūtu vairāk informācijas, apmeklējiet oficiālo React dokumentāciju un Vite dokumentāciju.