ShahadatShuvo / NewsWave

A news based blog project, created with NextJS and Django

NewsWave

Next.js and Django Full Stack Project

This is a full-stack News blog built using Next.js and Django. It combines the power of React-based frontend with a Django backend to create a robust and dynamic web application.

Frontend

frontend Live Server: coming soon...

This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Inter, a custom Google Font.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

Backend

Backend Live server: coming soon...

The backend is built using Django, a high-level Python web framework. It handles the server-side logic and provides APIs for the front-end to interact with.

Prerequisites

Before running the backend, ensure that you have the following software installed:

• Python (version > 3.10)
• Django (version 4.2.1)

Installation

1. Navigate to the backend directory: cd backend.
2. Create a virtual environment (recommended): python -m venv venv || py -m venv venv. [If not installed]
3. Activate the virtual environment:
   • On Windows: venv\Scripts\activate.bat
   • On macOS/Linux: source venv/bin/activate
4. Install the dependencies: pip install -r requirements.txt. [If not installed]
5. Apply the database migrations: python manage.py migrate. [If not installed]
6. Start the development server: python manage.py runserver.
7. Open your web browser and visit http://localhost:8000 to view the backend API.

Folder Structure

The backend code is organized as follows:

• manage.py: The entry point for Django commands.
• backend/: The Django project directory.
• api/: Contains the API views, serializers, and URLs.
• models/: Contains the database models.
• views/: Contains additional views or viewsets.

Contributing

If you would like to contribute to this project, feel free to open a pull request or submit an issue. Contributions are always welcome!

License

This project is licensed under the MIT License.