With the advent of TypeScript, web development has become more efficient, reliable, and scalable. However, setting up a TypeScript project from scratch can be daunting and time-consuming. That's where Create-T3-App comes in - a new tool that streamlines the process of creating TypeScript applications and makes backend-frontend integration much faster and easier.
In this blog post, we'll discuss how to start using Create-T3-App and why it's better and beneficial.
Getting Started with Create-T3-App
To get started with Create-T3-App, you need to have Node.js and npm installed on your machine. Once you have them installed, open up your terminal and type the following command:
npm install -g create-t3-app
Then, you can create a new project with:
create-t3-app my-app
This will create a folder called my-app with the following structure:
my-app
├── client
│ ├── public
│ ├── src
│ └── package.json
├── server
│ ├── src
│ └── package.json
└── package.json
The client folder contains the React front-end code, and the server folder contains the Express back-end code. Both are written in TypeScript and have their own package.json files with the necessary dependencies and scripts. The root package.json file allows you to run both the client and the server concurrently with one command:
npm start
This will launch the front-end on http://localhost:3000 and the back-end on http://localhost:5000. You can also run them separately with:
npm run client
npm run server
The create-t3-app tool also sets up some useful features for you, such as:
- Hot reloading for both the front-end and the back-end with webpack and nodemon.
- Linting and formatting with ESLint and Prettier.
- Testing with Jest and React Testing Library.
- Type checking with TypeScript.
- Proxying requests from the front-end to the back-end with http-proxy-middleware.
Why Create-T3-App is Better and Beneficial
Create-T3-App is a comprehensive boilerplate that provides a solid foundation for building TypeScript applications. Here are some reasons why it's better and beneficial:
Faster Development
Create-T3-App eliminates the need for setting up a TypeScript project from scratch, saving you a lot of time and effort. It comes with all the necessary tools and configurations needed for a TypeScript project, such as TypeScript, ESLint, Prettier, and Jest.Scalability
Create-T3-App provides a scalable architecture that separates the frontend and backend into separate folders. This separation allows for easier maintenance and scalability of the application as it grows.Improved Backend-Frontend Integration
One of the biggest benefits of Create-T3-App is its ability to streamline the integration between the backend and frontend. The backend is built using Node.js and Express, while the frontend is built using React. The two are connected using a proxy configuration in the package.json file, which enables requests from the frontend to be proxied to the backend. This configuration eliminates the need for CORS handling and makes backend-frontend integration much faster and easier.Typescript Support
Create-T3-App is built with TypeScript, which provides strong typing and better code analysis. This ensures that your code is more reliable, efficient, and easier to maintain.
With create-t3-app, you can save time and effort by having a ready-made project structure that follows best practices and supports modern web development. You can focus on writing your business logic and creating your user interface without worrying about the configuration and setup. You can also enjoy the benefits of TypeScript, such as type safety, code completion, and refactoring. If you are looking for a fast and easy way to create a full-stack TypeScript web application, give create-t3-app a try today!
How to Add Clerk as a User Authentication with Create-T3-App
Create-T3-App comes with built-in user authentication using Passport.js, but you can also integrate Clerk for a more robust and secure authentication system. Clerk provides a user authentication and identity management system that's easy to use and highly customizable.
Here are the steps to add Clerk as a user authentication with Create-T3-App:
Create a Clerk account and project - First, create a Clerk account and a new project. Once you have your project set up, you can get your API key and API URL.
Install Clerk SDK - Next, install the Clerk SDK by running the following command:
npm install @clerk/clerk-sdk-node
- Configure Clerk - In the
config.ts
file, add the following code to configure Clerk:
clerk: {
apiKey: process.env.CLERK_API_KEY!,
apiBaseUrl: process.env.CLERK_API_BASE_URL!,
},
Make sure to replace process.env.CLERK_API_KEY!
and process.env.CLERK_API_BASE_URL!
with your Clerk API key and API URL.
- Implement Clerk - In the
server.ts
file, replace thepassport
middleware with Clerk. Here's an example:
const clerk = new Clerk({
apiKey: config.clerk.apiKey,
apiBaseUrl: config.clerk.apiBaseUrl,
});
app.use(clerk.middleware);
app.post('/api/auth/signout', clerk.controllers.handleSignout);
// Protect routes with Clerk
app.use('/api/*', clerk.protect({ requireVerified: true }), apiRouter);
This code initializes Clerk, adds the Clerk middleware, and protects routes with Clerk. Note that the requireVerified
option requires users to verify their email address before they can access protected routes.
- Update Login and Logout Routes - In the
routes/auth.ts
file, replace thepassport.authenticate
middleware with Clerk. Here's an example:
router.post('/login', clerk.controllers.signIn);
router.post('/logout', clerk.controllers.handleSignout);
This code uses the Clerk signIn
and handleSignout
controllers for login and logout routes.
With these steps, you can now use Clerk as a user authentication system in your Create-T3-App project. Clerk provides a robust and secure authentication system that's easy to integrate and customize.
Happy Coding!
👋 Hi, I’m @chnspart
👀 I’m interested in Javascript
🌱 I’m currently learning Nest.JS & Next.JS
📫 How to reach me imchn24@gmail.com
🏀 My designs Portfolios https://behance.net/chnspart/ ※ https://dribbble.com/chnspart/
🌐 My website https://chnspart.com
Top comments (0)