Plann.er is a collaborative trip planning web application designed to help you organize and manage your trips effectively. With Plann.er, you can plan your trip, create daily activities, share important links, and invite others to contribute to the planning process.
- Trip Planning: Create and manage trips with detailed itineraries.
- Collaborative Planning: Invite friends or family to join the planning process.
- Activity Management: Organize activities for each day of your trip.
- Link Sharing: Share important links and resources with all participants.
- User Invitations: Easily invite more people to participate in the trip.
-
Frontend:
- React with TypeScript
- Tailwind CSS
- Vite
-
Backend:
- Node.js with Fastify
- TypeScript
- Prisma ORM
-
Database:
- SQLite
Ensure you have the following installed:
- Node.js (version 14.x or higher)
- npm or yarn
-
Clone the repository:
git clone https://github.com/Sampasbc/plann.er_group-trip-planning.git cd plann.er
-
Navigate to the frontend directory:
cd client
-
Install dependencies:
npm install
or
yarn install
-
Start the development server:
npm run dev
or
yarn dev
-
Navigate to the backend directory:
cd ../server
-
Install dependencies:
npm install
or
yarn install
-
Set up the database:
npx prisma migrate dev
-
Settup environmental variables:
Create a .env file on "/server" if needed.
On your .env file look for these variables and change them accordingly:
DATABASE_URL="file:./dev.db" // This is the API host API_BASE_URL = "[your network IP or https://localhost]" PORT = "[a port for the API (ex. 3333)]" // This is the Client host CLIENT_BASE_URL = "[your network IP or https://localhost]" CLIENT_PORT = "[a port for the client (ex. 5555)]"
-
Start the server:
npm run dev
or
yarn dev
The backend will be available at
http://[your custom API host]:[your custom API port]
.
-
Open the application:
Navigate to
http://[your custom Client host]:[your custom Client port]
in your browser to access the Plann.er app. -
Create a Trip:
Use the interface to create a new trip and start planning your itinerary.
-
Invite Participants:
Invite friends and family to join your trip and collaborate on planning.
-
Plan Activities:
Add and organize activities for each day of your trip.
-
Share Links:
Share important links and resources with your trip participants.
We welcome contributions to Plann.er! To get started:
- Fork the repository.
- Create a new branch for your feature or bug fix.
- Make your changes and ensure tests are passing.
- Submit a pull request with a detailed description of your changes.
This project is licensed under the MIT License. See the LICENSE file for details.
For any questions or support, please reach out to fernandosbcunha@gmail.com