This mono-repo is a comprehensive starter kit for building modern web applications. It comes pre-configured with a robust set of tools and technologies to accelerate your startup development process.
- Full-Stack Setup: Includes both frontend and backend configurations.
- Authentication: Pre-configured authentication system.
- Firebase Integration: Ready-to-use Firebase backend support.
- Modern Frontend: React-based frontend with TypeScript and Tailwind CSS.
- UI Components: Integrated shadcn components for rapid UI development.
- Backend: Node.js and Express server with TypeScript support.
mono-repo/
├── frontend/
│ ├── public
│ ├── src
│ ├── ├── components (All Components)
│ ├── ├── ├── components (All Components)
│ ├── ├── ├── ├── shadcn (Shadcn components)
│ ├── ├── ├── ├── aceturnity (Aceturnity components)
│ ├── ├── ├── └── ui (tailoured ui components for pages)
│ ├── ├── contexts (Provider and contexts managing cross-component states)
│ ├── ├── layouts (Generic page layouts, i.e. scrollable with navbar & footer)
│ ├── ├── pages (page components for unique location)
│ ├── ├── lib (utility components i.e. cn())
│ ├── └── lib (utility components i.e. cn())
│ |── Tailwind config
│ └── Typescript config
├── backend/
│ ├── Node.js
│ ├── Express
│ └── TypeScript
└── shared/
└── (Shared types, utilities, etc.)
-
Clone this repository
-
Run the installation script:
./installation-script.sh -
Set up your Firebase configuration
-
Start developing!
The frontend is built with React and TypeScript, offering a modern and type-safe development experience. It utilizes Tailwind CSS for styling and includes shadcn components for rapid UI prototyping and development.
The backend is powered by Node.js and Express, written in TypeScript for improved maintainability and developer experience. It's pre-configured to work seamlessly with Firebase services.
Authentication is pre-setup and integrated with Firebase, providing a secure and scalable solution out of the box. All you need to do is add the environment secrets from firebase in the .env file in the frontend directory.
- Then
This project comes with Firebase backend support, allowing you to leverage Firebase's powerful features such as real-time database, cloud functions, and more.
- To start the frontend development server:
cd frontend && npm start - To start the backend development server:
cd backend && npm run dev - To start both frontend and backend server in the main server:
npm start
[Add specific deployment instructions based on your preferred hosting platforms]
[Add contribution guidelines if this is an open-source project]
[Specify the license for your project]
This README provides a high-level overview of your mono-repo setup, highlighting its key features and technologies. It also includes basic instructions for getting started and running the project.
You may want to customize this further based on specific details of your project, such as:
1. More detailed setup instructions
2. Specific versions of major dependencies
3. Any particular coding standards or practices you follow
4. Details about your deployment process
5. Information about your testing setup
6. Any other unique features or integrations in your project
A lot of the functionality is generic and introduces gaurd rails wherever appropriate but please do update and feel free to contribute to this mono-repo structure.